Reference

memchr(3)

locate byte in memory object

NAME

memchr – locate byte in memory object

LIBRARY

Standard C Library (libc, -lc)

SYNOPSIS

#include <string.h>

QVoid *

memchr(QVoid *b, int c, size_t len);

QVoid *

memrchr(QVoid *b, int c, size_t len);

DESCRIPTION

The memchr() function locates the first occurrence of c (converted to an unsigned char) in object b, limited to at most len characters.

The memrchr() function behaves like memchr(), except that it locates the last occurrence of c in object b, limited to the first len characters.

RETURN VALUES

The memchr() and memrchr() functions return a pointer to the byte located, or NULL if no such byte exists within len bytes.

SEE ALSO

memmem(3), strchr(3), strcspn(3), strpbrk(3), strrchr(3), strsep(3), strspn(3), strstr(3), strtok(3), wmemchr(3)

STANDARDS

The memchr() function conforms to ISO/IEC 9899:2024 (“ISO C23”), where it is specified as a qualifier-preserving function.

The memrchr() function is a GNU extension and conforms to no standard. Like the qualifier-preserving functions in ISO/IEC 9899:2024 (“ISO C23”), FreeBSD implements memrchr() as qualifier-preserving as well.

HISTORY

The memrchr() function first appeared in GNU libc 2.1.91, this implementation first appeared in FreeBSD 6.4, coming from OpenBSD 4.3.

History