Namespaces
Variants

strcoll

From cppreference.net
< c ‎ | string ‎ | byte
ヘッダーで定義 <string.h>
int strcoll ( const char * lhs, const char * rhs ) ;

現在のロケール( LC_COLLATE カテゴリで定義)に従って2つのヌル終了バイト文字列を比較します。

目次

パラメータ

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

戻り値

  • lhs rhs より 小さい (先行する)場合、負の値。
  • lhs rhs 等しい 場合、 0
  • 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");
    // 代替案として、ISO-8859-2(別名 Latin-2)も
    // 一部の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 strcoll関数 (p: TBD)
  • C17規格 (ISO/IEC 9899:2018):
  • 7.24.4.3 strcoll関数 (p: 未定)
  • C11規格 (ISO/IEC 9899:2011):
  • 7.24.4.3 strcoll関数 (p: 366)
  • C99規格 (ISO/IEC 9899:1999):
  • 7.21.4.3 strcoll関数 (p: 329)
  • C89/C90標準 (ISO/IEC 9899:1990):
  • 4.11.4.3 strcoll関数

関連項目

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