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*。 - 否则，行为未定义。
- 如果
如果在搜索的数组末尾之外发生访问，则行为未定义。如果 ptr 是空指针，则行为未定义。
|
此函数的行为就好像它按顺序读取字节，并在找到匹配字节后立即停止：如果 ptr 指向的数组小于 count，但在数组中找到匹配项，则行为是明确定义的。 |
(自 C11 起) |
目录 |
[edit] 参数
| ptr | - | 要检查的对象的指针 |
| ch | - | 要搜索的字节 |
| count | - | 要检查的最大字节数 |
[edit] 返回值
指向字节位置的指针，如果未找到此类字节，则为空指针。
[edit] 示例
运行此代码
#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
[edit] 参考文献
- C23 标准 (ISO/IEC 9899:2024)
- 7.24.5.1 memchr 函数 (p: 待定)
- 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 函数
[edit] 参见
| 查找字符的首次出现 (函数) | |
| C++ 文档 关于 memchr
| |
