STRCHR(3)              FreeBSD Library Functions Manual              STRCHR(3)

NAME

     strchr, strrchr, strchrnul - locate character in string

LIBRARY

     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 function strchrnul() is a GNU extension.

HISTORY

     The strchrnul() function first appeared in glibc 2.1.1 and was added in
     FreeBSD 10.0.

FreeBSD 15.1-STABLE-HBSD       February 13, 2013                     STRCHR(3)