strcoll

来自cppreference.com
< c‎ | string‎ | byte
在标头 <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 <stdio.h>
#include <string.h>
#include <locale.h>
 
int main(void)
{
    setlocale(LC_COLLATE, "cs_CZ.utf8");
    // 此外,某些 OS 上 ISO-8859-2(亦即 Latin-2)
    // 也能工作:
    // 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 (第 TBD 页)
  • C17 标准(ISO/IEC 9899:2018):
  • 7.24.4.3 The strcoll function (第 TBD 页)
  • C11 标准(ISO/IEC 9899:2011):
  • 7.24.4.3 The strcoll function (第 366 页)
  • C99 标准(ISO/IEC 9899:1999):
  • 7.21.4.3 The strcoll function (第 329 页)
  • C89/C90 标准(ISO/IEC 9899:1990):
  • 4.11.4.3 The strcoll function

参阅

根据当前本地环境比较两个宽字符串
(函数)
变换字符串,使得 strcmp 会产生同 strcoll 的结果
(函数)
变换宽字符串,使得 wcscmp 会产生与 wcscoll 相同的结果
(函数)
比较两个字符串
(函数)