STRCHR(3) | FreeBSD Library Functions Manual | STRCHR(3) |
NAME
strchr, strrchr, strchrnul — locate character in stringLIBRARY
Standard C Library (libc, -lc)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
The strchr() 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.February 13, 2013 | FreeBSD |