std::wmemcmp

 

C++

编译器支持

独立和托管

语言

标准库

标准库头文件

命名要求

功能测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用实用程序库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

并发支持库 (C++11)

执行支持库 (C++26)

技术规范

符号索引

外部库

 

字符串库

以空字符结尾的字符串

字节字符串

多字节字符串

宽字符串

类

basic_string

basic_string_view (C++17)

char_traits

 

以空字符结尾的宽字符串

函数
字符操作
iswalnum iswalpha iswlower iswupper iswdigit iswxdigit iswblank (C++11)   wctype iswctype	iswcntrl iswgraph iswspace iswprint iswpunct towlower towupper wctrans towctrans
转换为数字格式
wcstolwcstoll (C++11) wcstoulwcstoull (C++11)	wcstofwcstodwcstold (C++11)(C++11) wcstoimaxwcstouimax (C++11)(C++11)
字符串操作
wcslen wcscpy wcsncpy wcscat wcsncat wcscmp wcscoll wcsncmp	wcsxfrm wcschr wcsrchr wcspbrk wcsspn wcscspn wcsstr wcstok
数组操作
wmemcpy wmemmove wmemcmp	wmemchr wmemset

 

定义在头文件 <cwchar> 中
int wmemcmp( const wchar_t* lhs, const wchar_t* rhs, std::size_t count );

比较由 lhs 和 rhs 指向的宽字符数组的前 count 个宽字符。比较按字典顺序进行。

结果的符号与被比较数组中第一个不同的宽字符的值之间的差值的符号相同。

如果 count 为零，则该函数不执行任何操作。

参数

lhs, rhs	-	指向要比较的宽字符数组的指针
count	-	要检查的宽字符数

返回值

如果 lhs 中第一个不同的宽字符的值小于 rhs 中对应宽字符的值，则为负值： lhs 在字典顺序中位于 rhs 之前。

​0​ 如果 lhs 和 rhs 的所有 count 个宽字符都相等。

如果 lhs 中第一个不同的宽字符的值大于 rhs 中对应宽字符的值，则为正值： rhs 在字典顺序中位于 lhs 之前。

备注

此函数不区分区域设置，并且不关注它检查的 wchar_t 对象的值：空字符和无效的宽字符也会被比较。

示例

运行此代码

#include <clocale>
#include <cwchar>
#include <iostream>
#include <locale>
#include <string>
 
void demo(const wchar_t* lhs, const wchar_t* rhs, std::size_t sz)
{
    std::wcout << std::wstring(lhs, sz);
    int rc = std::wmemcmp(lhs, rhs, sz);
    if (rc == 0)
        std::wcout << " compares equal to ";
    else if (rc < 0)
        std::wcout << " precedes ";
    else if (rc > 0)
        std::wcout << " follows ";
    std::wcout << std::wstring(rhs, sz) << " in lexicographical order\n";
}
 
int main()
{
    std::setlocale(LC_ALL, "en_US.utf8");
    std::wcout.imbue(std::locale("en_US.utf8"));
 
    wchar_t a1[] = {L'α',L'β',L'γ'};
    constexpr std::size_t sz = sizeof a1 / sizeof *a1;
    wchar_t a2[sz] = {L'α',L'β',L'δ'};
 
    demo(a1, a2, sz);
    demo(a2, a1, sz);
    demo(a1, a1, sz);
}

可能的输出

αβγ precedes αβδ in lexicographical order
αβδ follows αβγ in lexicographical order
αβγ compares equal to αβγ in lexicographical order

参见

wcscmp	比较两个宽字符串 (函数)
memcmp	比较两个缓冲区 (函数)
wcsncmp	比较两个宽字符串中一定数量的字符 (函数)
C 文档 for wmemcmp