C++ 函数：wcscoll()

C++ 标准库中的 wcscoll() 函数用于比较两个宽字符串（Unicode 字符串）的字典序，其具体定义如下：

int wcscoll(const wchar_t* str1, const wchar_t* str2);

该函数接受两个参数，分别是被比较的两个宽字符串 str1 和 str2。函数返回值为整数，可以分为以下三种情况：

• 如果 str1 与 str2 相等，则 wcscoll() 返回值为零。
• 如果 str1 紧接着 str2 排在字典序之后，则 wcscoll() 返回值为小于零的整数。
• 如果 str1 的字典序在 str2 之前，则 wcscoll() 返回值为大于零的整数。

wcscoll() 函数支持以当前 C++ 环境（即所在操作系统和区域设置）的本地化设置和排序规则来执行比较操作。这使得 wcscoll() 函数可以向用户保证两个不同语言的字符串可以被以可预期的方式进行比较。

下面是一个示例程序，该程序使用 wcscoll() 函数来比较两个字符串的字典序，并输出比较结果。

#include <iostream>
#include <cstring>
#include <cwchar>
#include <locale>

int main()
{
    setlocale(LC_ALL, "");  // 使用用户本地化设置

    std::wstring str1 = L"Hello, 世界";
    std::wstring str2 = L"Bonjour, le monde";

    int cmp = wcscoll(str1.c_str(), str2.c_str());
    if (cmp == 0) {
        std::wcout << str1 << " equals " << str2 << std::endl;
    }
    else if (cmp < 0) {
        std::wcout << str1 << " comes before " << str2 << std::endl;
    }
    else {
        std::wcout << str1 << " comes after " << str2 << std::endl;
    }

    return 0;
}

输出结果如下：

Bonjour, le monde comes after Hello, 世界

在上面的程序中，我们使用 std::wstring 来存储宽字符串。我们还使用了 setlocale() 函数来将当前程序的区域设置与所在操作系统和用户设置相匹配。这有助于保证 wcscoll() 函数会使用正确的本地化设置来执行字符串比较操作。程序输出结果表明，str1 的字典序在 str2 之后。