strcoll

 

C

コンパイラサポート

言語

ヘッダー

型サポート

プログラムユーティリティ

可変長引数関数のサポート

エラーハンドリング

動的メモリ管理

文字列ライブラリ

アルゴリズム

数値

日付と時刻のユーティリティ

入出力サポート

ローカライゼーションサポート

並行処理サポート (C11)

技術仕様

シンボルインデックス

 

文字列ライブラリ

ヌル終端バイト文字列

ヌル終端マルチバイト文字列

ヌル終端ワイド文字列

 

ヌル終端バイト文字列

関数
文字操作
isalnum isalpha islower isupper isdigit isxdigit isblank (C99)	iscntrl isgraph isspace isprint ispunct tolower toupper
数値フォーマットとの変換
atoiatolatoll (C99) atof strtolstrtoll (C99) strtoulstrtoull (C99)	strtoimaxstrtoumax (C99)(C99) strtofstrtodstrtold (C99)(C99) strfromfstrfromdstrfroml (C23)(C23)(C23)
文字列操作
strcpystrcpy_s (C11) strncpystrncpy_s (C11) strcatstrcat_s (C11)	strncatstrncat_s (C11) strxfrm strdup (C23) strndup (C23)
文字列検査
strlenstrnlen_s (C11) strcmp strncmp strcoll strchr strrchr	strspn strcspn strpbrk strstr strtokstrtok_s (C11)
メモリ操作
memchr memcmp memsetmemset_explicitmemset_s (C23)(C11)	memcpymemcpy_s (C11) memmovememmove_s (C11) memccpy (C23)
その他
strerrorstrerror_sstrerrorlen_s (C11)(C11)

 

ヘッダー <string.h> で定義
int strcoll( const char* lhs, const char* rhs );

現在のロケール（LC_COLLATE カテゴリで定義される）に従って、2つのヌル終端バイト文字列を比較します。

パラメータ

lhs, rhs

-

比較するヌル終端バイト文字列へのポインタ

戻り値

• lhs が rhs より小さい（先行する）場合、負の値。
• ​0​ if lhs が rhs と等しい場合。
• lhs が rhs より大きい（後続する）場合、正の値。

注釈

照合順序は辞書順です。文字の（その同等クラスにおける）位置は、大文字・小文字やバリアントよりも優先されます。同等クラス内では、小文字は対応する大文字よりも前に照合され、アクセント記号付き文字にはロケール固有の順序が適用される場合があります。一部のロケールでは、文字のグループが単一の照合単位として比較されます。たとえば、チェコ語の "ch" は "h" の後に、"i" の前に来ます。ハンガリー語の "dzs" は "dz" の後に、"g" の前に来ます。

例

このコードを実行

#include <locale.h>
#include <stdio.h>
#include <string.h>
 
int main(void)
{
    setlocale(LC_COLLATE, "cs_CZ.utf8");
    // Alternatively, ISO-8859-2 (a.k.a. Latin-2)
    // may also work on some OS:
    // setlocale(LC_COLLATE, "cs_CZ.iso88592");
 
    const char* s1 = "hrnec";
    const char* s2 = "chrt";
 
    printf("In the Czech locale: ");
    if (strcoll(s1, s2) < 0)
        printf("%s before %s\n", s1, s2);
    else
        printf("%s before %s\n", s2, s1);
 
    printf("In lexicographical comparison: ");
    if (strcmp(s1, s2) < 0)
        printf("%s before %s\n", s1, s2);
    else
        printf("%s before %s\n", s2, s1);
}

出力

In the Czech locale: hrnec before chrt
In lexicographical comparison: chrt before hrnec

参考文献

• C23標準 (ISO/IEC 9899:2024)

• 7.24.4.3 The strcoll function (p: TBD)

• C17標準 (ISO/IEC 9899:2018)

• 7.24.4.3 The strcoll function (p: TBD)

• C11標準 (ISO/IEC 9899:2011)

• 7.24.4.3 The strcoll function (p: 366)

• C99標準 (ISO/IEC 9899:1999)

• 7.21.4.3 The strcoll function (p: 329)

• C89/C90標準 (ISO/IEC 9899:1990)

• 4.11.4.3 The strcoll function

関連項目

wcscoll (C95)	現在のロケールに従って2つのワイド文字列を比較する (関数)
strxfrm	strcmp が strcoll と同じ結果になるように文字列を変換する (関数)
wcsxfrm (C95)	wcscmpがwcscollと同じ結果を生成するようにワイド文字列を変換する (関数)
strcmp	2つの文字列を比較する (関数)
C++ ドキュメント strcoll