NAME
strchr, strrchr,
strchrnul —
locate character in string
LIBRARY
library “libc”
SYNOPSIS
#include
<string.h>
char *
strchr(const
char *s, int
c);
char *
strrchr(const
char *s, int
c);
char *
strchrnul(const
char *s, int
c);
DESCRIPTION
Thestrchr()
function locates the first occurrence of c (converted to
a char) in the string pointed to by
s. The terminating null character is considered part of
the string; therefore if c is
‘\0’, the functions locate the
terminating ‘\0’.
The
strrchr()
function is identical to strchr() except it locates
the last occurrence of c.
The
strchrnul()
function is identical to strchr() except that if
c is not found in s a pointer to
the terminating ‘\0’ is returned.
RETURN VALUES
The functions strchr() and
strrchr() return a pointer to the located character,
or NULL if the character does not appear in the
string.
strchrnul() returns a pointer to the
terminating ‘\0’ if the character does
not appear in the string.
SEE ALSO
memchr(3), memmem(3), strcspn(3), strpbrk(3), strsep(3), strspn(3), strstr(3), strtok(3), wcschr(3)
STANDARDS
The functions strchr() and
strrchr() conform to ISO/IEC
9899:1990 (“ISO C90”). The
strchrnul() is a GNU extension .
History
The
strchrnul()
function first appeared in glibc 2.1.1 and was added in
FreeBSD 10.0.