Skip site navigation (1)Skip section navigation (2)

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
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 strchrnul() is	a GNU extension	.

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

FreeBSD	10.1		       February	13, 2013		  FreeBSD 10.1

NAME | LIBRARY | SYNOPSIS | DESCRIPTION | RETURN VALUES | SEE ALSO | STANDARDS | History

Want to link to this manual page? Use this URL:
<http://www.freebsd.org/cgi/man.cgi?query=strchr&sektion=3&manpath=FreeBSD+10.1-RELEASE>

home | help