#C 语言标准库函数 strcoll

/*********************************************
 * @brief 比较两个字符串是否相同
 * @param lhs 要比较的字符串
 * @param rhs 要比较的字符串
 * @return 字符串的差异
 ********************************************/
int strcoll(const char* lhs, const char* rhs);

说明

按照语言环境进行字符串比较。

相当于将字符串通过 strxfrm 进行转换后，再通过 strcmp 进行比较。

参数

• lhs - 要比较的字符串
• rhs - 要比较的字符串

返回值

• 如果字符串相同，则返回 0
• 如果当前语言环境下 lhs 在 rhs 之前，则返回负值
• 如果当前语言环境下 lhs 在 rhs 之后，则返回正值

#示例

#include <stdio.h>
#include <locale.h>
#include <string.h>

int main(void)
{
    // 设置语言环境
    if (setlocale(LC_COLLATE, "zh_CN.UTF-8") == NULL)
    {
        fprintf(stderr, "语言环境设置失败\n");
        return 1;
    }

    const char* lhs = "你好";
    const char* rhs = "世界";

    // 按照编码的字节比较字符串
    if (strcmp(lhs, rhs) < 0)
    {
        printf("按照编码字节排序，\"%s\" 在 \"%s\" 之前\n", lhs, rhs);
    }
    else
    {
        printf("按照编码字节排序，\"%s\" 在 \"%s\" 之后\n", lhs, rhs);
    }

    // 按照语言环境比较字符串
    if (strcoll(lhs, rhs) < 0)
    {
        printf("按照汉语拼音排序，\"%s\" 在 \"%s\" 之前\n", lhs, rhs);
    }
    else
    {
        printf("按照汉语拼音排序，\"%s\" 在 \"%s\" 之后\n", lhs, rhs);
    }

    return 0;
}

说明：

• 首先通过 setlocale 设置语言环境
• 中文转换后按照汉语拼音排序

运行结果：

按照编码字节排序，"你好" 在 "世界" 之后
按照汉语拼音排序，"你好" 在 "世界" 之前

#推荐阅读

• C 语言标准库函数 strxfrm
• C 语言标准库函数 strcmp
• strcoll - cppreference

#参考标准

• C23 standard (ISO/IEC 9899:2024):
  • 7.24.4.3 The strcoll function (p: TBD)
• C17 standard (ISO/IEC 9899:2018):
  • 7.24.4.3 The strcoll function (p: TBD)
• C11 standard (ISO/IEC 9899:2011):
  • 7.24.4.3 The strcoll function (p: 366)
• C99 standard (ISO/IEC 9899:1999):
  • 7.21.4.3 The strcoll function (p: 329)
• C89/C90 standard (ISO/IEC 9899:1990):
  • 4.11.4.3 The strcoll function