命名空间
变体
操作

wmemchr

来自 cppreference.cn
< c‎ | string‎ | wide
在头文件 <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) 在 `ptr` 指向的宽字符数组或兼容类型的整数数组的初始 `count` 个宽字符中,查找宽字符 `ch` 的第一次出现。
2) 等同于 (1) 的类型泛型函数。令 T 为不带限定符的宽字符对象类型。
  • 如果 `ptr` 的类型是 `const T*`,则返回类型是 `const wchar_t*`。
  • 否则,如果 `ptr` 的类型是 `T*`,则返回类型是 `wchar_t*`。
  • 否则,行为未定义。
如果抑制这些通用函数中的每个宏定义以访问实际函数(例如,如果使用 `(wmemchr)` 或函数指针),则实际函数声明 (1) 将可见。

如果 `count` 为零,则函数返回一个空指针。

目录

[编辑] 参数

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

[编辑] 返回值

指向宽字符位置的指针,如果找不到该字符,则为 null 指针。

[编辑] 示例

#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: 待定)
  • C17 标准 (ISO/IEC 9899:2018)
  • 7.29.4.5.8 wmemchr 函数 (p: 待定)
  • 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)

[编辑] 另请参阅

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