memchr
来自 cppreference.cn
| 定义于头文件 <string.h> |
||
| void* memchr( const void* ptr, int ch, size_t count ); |
(1) | |
| /*QVoid*/ *memchr( /*QVoid*/ *ptr, int ch, size_t count ); |
(2) | (自 C23 起) |
1) 在
ptr 指向的对象的最初 count 字节（每个字节都解释为 unsigned char）中，查找 (unsigned char)ch 的首次出现。2) 泛型函数，等价于 (1)。令
T 为非限定对象类型（包括 void）。- 如果
ptr的类型为const T*，则返回类型为const void*。 - 否则，如果
ptr的类型为T*，则返回类型为void*。 - 否则，行为未定义。
- 如果
(memchr) 或函数指针），则实际函数声明 (1) 将变得可见。如果访问超出了搜索数组的末尾，则行为是未定义的。如果 ptr 是空指针，则行为是未定义的。
|
此函数的行为就像它顺序读取字节并在找到匹配字节时立即停止：如果 |
(C11 起) |
目录 |
[编辑] 参数
| ptr | - | 指向要检查的对象的指针 |
| ch | - | 要搜索的字节 |
| count | - | 要检查的最大字节数 |
[编辑] 返回值
指向字节位置的指针，如果未找到此类字节，则为空指针。
[编辑] 示例
运行此代码
#include <stdio.h> #include <string.h> int main(void) { const char str[] = "ABCDEFG"; const int chars[] = {'D', 'd'}; for (size_t i = 0; i < sizeof chars / (sizeof chars[0]); ++i) { const int c = chars[i]; const char *ps = memchr(str, c, strlen(str)); ps ? printf ("character '%c'(%i) found: %s\n", c, c, ps) : printf ("character '%c'(%i) not found\n", c, c); } return 0; }
可能的输出
character 'D'(68) found: DEFG character 'd'(100) not found
[编辑] 参考
- C23 标准 (ISO/IEC 9899:2024)
- 7.24.5.1 memchr 函数 (p: TBD)
- C17 标准 (ISO/IEC 9899:2018)
- 7.24.5.1 memchr 函数 (p: 267-268)
- C11 标准 (ISO/IEC 9899:2011)
- 7.24.5.1 memchr 函数 (p: 367)
- C99 标准 (ISO/IEC 9899:1999)
- 7.21.5.1 memchr 函数 (p: 330)
- C89/C90 标准 (ISO/IEC 9899:1990)
- 4.11.5.1 memchr 函数
[编辑] 另请参阅
| 查找字符的第一次出现 (函数) | |
| C++ 文档 关于 memchr
| |
