约 1733 字

约 9 分钟

#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'

#推荐阅读

#参考标准

  • 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

更新: 2025/10/25

作者: PlanC

创建: 2025/7/12