_mbsnbcoll、_mbsnbicoll

string.h：インデックス への移動

ヘッダー ファイル

mbstring.h

カテゴリ

メモリおよび文字列操作ルーチン

プロトタイプ

int _mbsnbcoll(const unsigned char *s1, const unsigned char *s2, maxlen);

int _mbsnbicoll(const unsigned char *s1, const unsigned char *s2, maxlen);

説明

_mbsnbicoll は _mbsnbcoll の大文字/小文字を区別しないバージョンです。

これらの関数は、引数 s1 および s2 で指定された文字列を照合します。 照合順序は、現在のマルチバイト コード ページで指定されている辞書式順序で決定されます。 最大 maxlen バイトが照合されます。

メモ： 辞書式順序は、文字セットにおける文字の順序と必ずしも同じではありません。

s1 または s2 の最終バイトがリード バイトである場合は、比較されません。

戻り値

これらの関数はそれぞれ、s1（またはその一部）と s2（またはその一部）を比較した結果に基づいて、以下のように整数値を返します。

• < 0（s1 が s2 より小さい場合）
• 0（s1 と s2 が同じ場合）
• > 0（s1 が s2 より大きい場合）

例

 #include <mbstring.h>
 /* This function is used in qsort to sort two arrays of strings */
 int qsort_func(char* left, char* right)
 {
   /* Obtain the lengths of both strings */
   int left_len = strlen(left);
   int right_len = strlen(right);
 
   /* Compare the two strings case-sensitively */
   return _mbsnbcoll(left, right, (left_len > right_len) ? right_len : left_len);
 }

エラーが発生した場合、これらの関数はそれぞれ _NLSCMPERROR を返します。