_strncoll、_wcsncoll、_mbsncoll、_strncoll_l、_wcsncoll_l、_mbsncoll_l
ロケール固有の情報を使用して文字列を比較します。
重要 |
---|
_mbsncoll と _mbsncoll_l は Windows ランタイムで実行されるアプリケーションで使用することはできません。詳細については、でサポート /ZW CRT 関数" "を参照してください。 |
int _strncoll(
const char *string1,
const char *string2,
size_t count
);
int _wcsncoll(
const wchar_t *string1,
const wchar_t *string2,
size_t count
);
int _mbsncoll(
const unsigned char *string1,
const unsigned char *string2,
size_t count
);
int _strncoll_l(
const char *string1,
const char *string2,
size_t count,
_locale_t locale
);
int _wcsncoll_l(
const wchar_t *string1,
const wchar_t *string2,
size_t count,
_locale_t locale
);
int _mbsncoll_l(
const unsigned char *string1,
const unsigned char *string2,
size_t count,
_locale_t locale
);
パラメーター
string1, string2
比較する、NULL で終わる文字列。count
比較する文字数。locale
使用するロケール。
戻り値
これらの関数は string1 と string2の部分文字列の関係を示す値を次のように返します。
戻り値 |
string1 が string2 の関係 |
---|---|
< 0 |
string1 が string2 より小さい。 |
0 |
string1 は string2 と同じです。 |
> 0 |
string1 が string2 より大きくなっています。 |
これらの関数は、を返します _NLSCMPERRORの各。_NLSCMPERRORを使用するには、STRING.h か MBSTRING.h を含めます。_wcsncoll は string1 か string2 が照合順序のドメインの外部にあるコードこれが含まれている場合は失敗します。エラーが発生した場合、_wcsncoll は EINVALに errno を設定している可能性があります。_wcsncollを呼び出した後に _wcsncoll呼び出しのエラーを確認するには、errno を 0 に設定し、をに errno をチェックします。
解説
これらの関数は、現在使用中のコード ページに従って string1 と string2で count の最初の文字の大文字と小文字を区別する比較を実行します。コード ページの文字セットの順序が辞書式の順序の違いがある場合のみ、この違いが文字列比較の対象である場合、これらの関数を使用します。文字セットの順序はロケール依存します。_l のサフィックスの使用は現在のロケール、これらの関数のバージョンが、_l のサフィックスの使用が渡されたロケールなるバージョン。詳細については、「ロケール」を参照してください。
これらの関数はすべて、パラメーターを検証します。string1string2 またはが null ポインターの場合、または count が INT_MAXより大きい場合、無効なパラメーター ハンドラーが パラメーターの検証に説明されているように、開始されます。実行の継続が許可された場合、これらの関数は _NLSCMPERROR を返し、errno を EINVAL に設定します。
汎用テキスト ルーチンのマップ
TCHAR.H のルーチン |
_UNICODE および _MBCS が未定義の場合 |
_MBCS が定義されている場合 |
_UNICODE が定義されている場合 |
---|---|---|---|
_tcsnccoll |
_strncoll |
_mbsncoll |
_wcsncoll |
_tcsncoll |
_strncoll |
_wcsncoll |
必要条件
ルーチン |
必須ヘッダー |
---|---|
_strncoll, _strncoll_l |
<string.h> |
_wcsncoll, _wcsncoll_l |
<wchar.h> か <string.h> |
_mbsncoll, _mbsncoll_l |
<mbstring.h> |
追加の互換性の詳細については、互換性を参照してください。
同等の .NET Framework 関数
参照
関連項目
_mbsnbcoll、_mbsnbcoll_l、_mbsnbicoll、_mbsnbicoll_l
_stricmp、_wcsicmp、_mbsicmp、_stricmp_l、_wcsicmp_l、_mbsicmp_l
strncmp、wcsncmp、_mbsncmp、_mbsncmp_l
_strnicmp、_wcsnicmp、_mbsnicmp、_strnicmp_l、_wcsnicmp_l、_mbsnicmp_l