std::wmemchr

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

功能特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

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

并发支持库 (C++11)

技术规范

符号索引

外部库

 

字符串库

空终止字符串

字节字符串

多字节字符串

宽字符串

类

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> 定义
const wchar_t* wmemchr( const wchar_t* ptr, wchar_t ch, std::size_t count );	(1)
wchar_t* wmemchr(       wchar_t* ptr, wchar_t ch, std::size_t count );	(2)

于 ptr 所指向的宽字符数组的前 count 个宽字符中，定位宽字符 ch 的首次出现。

若 count 为零，则函数返回空指针。

参数

ptr	-	指向要检验的宽字符数组的指针
ch	-	要搜索的宽字符
count	-	要检验的宽字符数

返回值

指向宽字符位置的指针，或若找不到这种字符则为空指针。

示例

运行此代码

#include <clocale>
#include <cwchar>
#include <iostream>
#include <locale>
 
int main()
{
    const wchar_t str[] = L"诺不轻信，故人不负我\0诺不轻许，故我不负人。";
    wchar_t target = L'许';
    const std::size_t sz = sizeof str / sizeof *str;
    if (const wchar_t* result = std::wmemchr(str, target, sz))
    {
        std::setlocale(LC_ALL, "en_US.utf8");
        std::wcout.imbue(std::locale("en_US.utf8"));
        std::wcout << "找到 '" << target << "' 于位置 " << result - str << '\n';
    }
}

可能的输出：

找到 '许' 于位置 14

参阅

memchr	在数组中搜索字符的首次出现 (函数)
strchr	寻找字符的首次出现 (函数)
wcschr	寻找宽字符串中宽字符的首次出现 (函数)
findfind_iffind_if_not (C++11)	寻找首个满足特定判别标准的元素 (函数模板)