_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 を返します。