strchr(3) [freebsd man page]

STRCHR(3)						   BSD 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 '', the functions locate the terminating ''.

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

BSD
								 February 13, 2013							       BSD

STRCHR(3)						     Linux Programmer's Manual							 STRCHR(3)

NAME

       strchr, strrchr, strchrnul - locate character in string

SYNOPSIS

       #include <string.h>

       char *strchr(const char *s, int c);

       char *strrchr(const char *s, int c);

       #define _GNU_SOURCE
       #include <string.h>

       char *strchrnul(const char *s, int c);

DESCRIPTION

       The strchr() function returns a pointer to the first occurrence of the character c in the string s.

       The strrchr() function returns a pointer to the last occurrence of the character c in the string s.

       The  strchrnul()  function is like strchr() except that if c is not found in s, then it returns a pointer to the null byte at the end of s,
       rather than NULL.

       Here "character" means "byte"; these functions do not work with wide or multibyte characters.

RETURN VALUE

       The strchr() and strrchr() functions return a pointer to the matched character or NULL if the character is not found.

       The strchrnul() function returns a pointer to the matched character, or a pointer to the null byte at the end of s (i.e.,  s+strlen(s))	if
       the character is not found.

VERSIONS

       strchrnul() first appeared in glibc in version 2.1.1.

CONFORMING TO

       strchr() and strrchr() are in SVr4, 4.3BSD, C89, C99.  strchrnul() is a GNU extension.

SEE ALSO

       index(3),  memchr(3),  rindex(3), string(3), strlen(3), strpbrk(3), strsep(3), strspn(3), strstr(3), strtok(3), wcschr(3), wcsrchr(3), fea-
       ture_test_macros(7)

COLOPHON

       This page is part of release 3.27 of the Linux man-pages project.  A description of the project, and information about reporting bugs,  can
       be found at http://www.kernel.org/doc/man-pages/.

GNU
								    2010-09-20								 STRCHR(3)