wmemchr

定义于头文件 `<wchar.h>`
wchar_t wmemchr( const wchar_t ptr, wchar_t ch, size_t count );	(1)	(C95 起)
/QWchar_t/ wmemchr( /Qwchar_t/ ptr, wchar_t ch, size_t count );	(2)	(C23 起)

1) 在宽字符数组或兼容类型的整数数组的初始 count 个宽字符中，定位宽字符 ch 的首次出现，数组由 ptr 指向。

2) 等价于 (1) 的类型泛型函数。设 T 为非限定的宽字符对象类型。

若 ptr 类型为 const T*，则返回类型为 const wchar_t*。
否则，若 ptr 类型为 T*，则返回类型为 wchar_t*。
否则，行为未定义。

若抑制每个泛型函数的宏定义以访问实际函数（例如，若使用 (wmemchr) 或函数指针），则实际函数声明 (1) 变为可见。

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

[编辑] 参数

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

[编辑] 返回值

指向宽字符位置的指针，如果未找到该字符，则为空指针。

[编辑] 示例

运行此代码

#include <locale.h>
#include <stdio.h>
#include <wchar.h>
 
int main(void)
{
    wchar_t str[] = L"诺不轻信，故人不负我\0诺不轻许，故我不负人。";
    size_t sz = sizeof str / sizeof *str;
 
    wchar_t target = L'许';
    wchar_t* result = wmemchr(str, target, sz);
 
    if (result)
    {
        setlocale(LC_ALL, "en_US.utf8");
        printf("Found '%lc' at position %td\n",target, result - str);
    }
}

可能的输出

Found '许' at position 14

[编辑] 参考

C23 标准 (ISO/IEC 9899:2024)

7.29.4.5.8 wmemchr 函数 (p: TBD)

C17 标准 (ISO/IEC 9899:2018)

7.29.4.5.8 wmemchr 函数 (p: TBD)

C11 标准 (ISO/IEC 9899:2011)

7.29.4.5.8 wmemchr 函数 (p: 438)

C99 标准 (ISO/IEC 9899:1999)

7.24.4.5.8 wmemchr 函数 (p: 384)

[编辑] 参见

memchr	在一个数组中搜索字符的首次出现 (函数) [编辑]
wcschr (C95)	在一个宽字符串中查找宽字符的首次出现 (函数) [编辑]
C++ 文档关于 wmemchr

编译器支持
语言
头文件
类型支持
程序工具
可变参数函数支持
错误处理
动态内存管理
字符串库
算法
数值
日期和时间工具
输入/输出支持
本地化支持
并发支持 (C11)
技术规范
符号索引

cppreference.cn

命名空间

变体

视图

操作