std::memchr

 

C++

编译器支持

独立和托管

语言

标准库

标准库头文件

命名需求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用实用程序库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

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

并发支持库 (C++11)

执行支持库 (C++26)

技术规范

符号索引

外部库

 

字符串库

以空字符结尾的字符串

字节字符串

多字节字符串

宽字符串

类

basic_string

basic_string_view (C++17)

char_traits

 

以空字符结尾的字节字符串

函数
字符操作
isalnum isalpha islower isupper isdigit isxdigit isblank (C++11)	iscntrl isgraph isspace isprint ispunct tolower toupper
转换为数字格式
atof atoiatolatoll (C++11) strtolstrtoll (C++11)	strtoulstrtoull (C++11) strtofstrtodstrtold (C++11)(C++11) strtoimaxstrtouimax (C++11)(C++11)
字符串操作
strcpy strncpy strxfrm	strcat strncat
字符串检查
strlen strcmp strncmp strcoll strchr strrchr	strspn strcspn strpbrk strstr strtok
内存操作
memchr memcmp memset	memcpy memmove
其他
strerror

 

定义在头文件 <cstring> 中
const void* memchr( const void* ptr, int ch, std::size_t count );
void* memchr(       void* ptr, int ch, std::size_t count );

将 ch 转换为 unsigned char，并在由 ptr 指向的对象的初始 count 个字节（每个字节都解释为 unsigned char）中定位该值的首次出现。

此函数的行为就好像它按顺序读取字节，并在找到匹配的字节后停止：如果由 ptr 指向的数组小于 count，但在数组中找到了匹配项，则行为是明确定义的。

(自 C++17 起)

参数

ptr	-	指向要检查的对象的指针
ch	-	要搜索的字节
count	-	要检查的最大字节数

返回值

指向字节位置的指针，如果未找到这样的字节，则为一个空指针。

示例

搜索一个字符数组。

运行此代码

#include <cstring>
#include <iostream>
 
int main()
{
    char arr[] = {'a', '\0', 'a', 'A', 'a', 'a', 'A', 'a'};
    char *pc = (char*) std::memchr(arr, 'A', sizeof arr);
    if (pc != nullptr)
        std::cout << "search character found\n";
    else
        std::cout << "search character not found\n";
}

输出

search character found

另请参阅

strchr	查找字符的首次出现 (函数)
findfind_iffind_if_not (C++11)	查找满足特定条件的第一个元素 (函数模板)
C 文档 针对 memchr