memchr

 

C

语言

头文件

类型支持

程序工具

变参数函数支持

动态内存管理

错误处理

日期和时间工具

字符串库

算法

数值

输入/输出支持

本地化支持

线程支持 (C11)

原子操作 (C11)

技术规范

 

字符串库

字节字符串

多字节字符串

宽字符串

 

空终止字节字符串

函数
字符操作
isalnum isalpha islower isupper isdigit isxdigit isblank (C99)	iscntrl isgraph isspace isprint ispunct tolower toupper
转换成数值格式
atof atoiatolatoll (C99) strtolstrtoll (C99)	strtoulstrtoull (C99) strtofstrtodstrtold (C99)(C99) strtoimaxstrtoumax (C99)(C99)
字符串操作
strcpystrcpy_s (C11)
strncpystrncpy_s (C11)
strcatstrcat_s (C11)
strncatstrncat_s (C11)
strxfrm
strdup (C23)
strndup (C23)
字符串检验
strlenstrnlen_s (C11) strcmp strncmp strcoll strchr strrchr	strspn strcspn strpbrk strstr strtokstrtok_s (C11)
内存操作
memchr
memcmp
memsetmemset_s (C11)
memcpymemcpy_s (C11)
memmovememmove_s (C11)
memccpy (C23)
杂项
strerrorstrerror_sstrerrorlen_s (C11)(C11)

 

定义于头文件 <string.h>
void* memchr( const void* ptr, int ch, size_t count );

在 ptr 所指向对象的首 count 个字符（每个都转译成 unsigned char ）中寻找 ch （在如同以 (unsigned char)ch 转换到 unsigned char 后）的首次出现。

若访问出现于被搜索的数组结尾后，则行为未定义。若 ptr 为空指针则行为未定义。

此函数表现如同它按顺序读取字符，并立即于找到匹配的字符时停止：若 ptr 所指向的字符数组小于 count ，但在数组中找到匹配，则行为良好定义。

(C11 起)

参数

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

返回值

指向字符位置的指针，或若找不到该字符则为空指针。

示例

运行此代码

#include <stdio.h>
#include <string.h>
 
int main(void)
{
    char str[] = "ABCDEFG";
    char *ps = memchr(str,'D',strlen(str));
    if (ps != NULL)
       printf ("search character found:  %s\n", ps);
    else
       printf ("search character not found\n");
 
    return 0;
}

输出：

search character found:  DEFG

引用

• C11 标准（ISO/IEC 9899:2011）：

• 7.24.5.1 The memchr function (p: 367)

• C99 标准（ISO/IEC 9899:1999）：

• 7.21.5.1 The memchr function (p: 330)

• C89/C90 标准（ISO/IEC 9899:1990）：

• 4.11.5.1 The memchr function

参阅

strchr

查找字符的首次出现 (函数)