strcoll
|
ヘッダーで定義
<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つの文字列を比較する
(関数) |
|
|
C++ documentation
for
strcoll
|
|