#C 语言标准库函数 memchr

/*********************************************
 * @brief 在内存块中查找字符
 * @param ptr 被检索的内存块地址
 * @param ch 要查找的字符
 * @param count 内存块的字节数
 * @return 指向找到的字符的指针
 ********************************************/
void* memchr(const void* ptr, int ch, size_t count);

说明

在 ptr 指向的内存块中查找字符 ch 字符，返回找到的第一个 ch 字符的地址。

参数

• ptr - 被检索的内存块地址
• ch - 要查找的字符
• count - 内存块的字节数

返回值

• 指向找到的字符的指针
• 如果没有找到目标字符，则返回 NULL

#示例

#include <stdio.h>
#include <string.h>

int main(void)
{
    const char bytes[] = {'h', 'e', 'l', 'l', 'o', 'w', 'o', 'r', 'l', 'd'};    // 被检索的内存块

    const char* ptr = bytes;
    while ((ptr = (const char*)memchr(ptr, 'l', sizeof(bytes) - (ptr - bytes))) != NULL)    // 循环查找 'l'
    {
        printf("地址:%p 偏移:%td 字符:'%c'\n", ptr, ptr - bytes, *(char*)ptr);
        ptr = ptr + 1;
    }

    return 0;
}

说明：

通过 memchr 循环查找字母 'l' 直到返回 NULL。

运行结果：

地址:0x7fff27821a40 偏移:2 字符:'l'
地址:0x7fff27821a41 偏移:3 字符:'l'
地址:0x7fff27821a46 偏移:8 字符:'l'

#推荐阅读

• C 语言标准库函数 strchr
• memchr - cppreference

#参考标准

• C23 standard (ISO/IEC 9899:2024):
  • 7.24.5.1 The memchr function (p: TBD)
• C17 standard (ISO/IEC 9899:2018):
  • 7.24.5.1 The memchr function (p: 267-268)
• C11 standard (ISO/IEC 9899:2011):
  • 7.24.5.1 The memchr function (p: 367)
• C99 standard (ISO/IEC 9899:1999):
  • 7.21.5.1 The memchr function (p: 330)
• C89/C90 standard (ISO/IEC 9899:1990):
  • 4.11.5.1 The memchr function