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 类别定义的当前区域设置，比较两个以空字符结尾的字节字符串。

参数

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");
    // 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: 待定)

• C17 标准 (ISO/IEC 9899:2018)

• 7.24.4.3 The strcoll function (p: 待定)

• 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)	根据当前语言环境比较两个宽字符串 (函数)
strxfrm	转换字符串，使 strcmp 产生与 strcoll 相同的结果 (函数)
wcsxfrm (C95)	转换宽字符串，使 wcscmp 产生与 wcscoll 相同的结果 (函数)
strcmp	比较两个字符串 (函数)
C++ documentation for strcoll