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

FreeBSD Manual Pages

  
 
  

home | help
STRSEP(3)		   Linux Programmer's Manual		     STRSEP(3)

NAME
       strsep -	extract	token from string

SYNOPSIS
       #include	<string.h>

       char *strsep(char **stringp, const char *delim);

DESCRIPTION
       If  *stringp is NULL, the strsep() function returns NULL	and does noth-
       ing else. Otherwise, this function finds	the first token	in the	string
       *stringp,  where	 tokens	 are delimited by symbols in the string	delim.
       This token is terminated	with a	`\0'  character	 (by  overwriting  the
       delimiter) and *stringp is updated to point past	the token.  In case no
       delimiter was found, the	 token	is  taken  to  be  the	entire	string
       *stringp, and *stringp is made NULL.

RETURN VALUE
       The  strsep()  function	returns	 a  pointer  to	the token, that	is, it
       returns the original value of *stringp.

NOTES
       The strsep() function was introduced as	a  replacement	for  strtok(),
       since  the  latter  cannot handle empty fields.	However, strtok() con-
       forms to	ANSI-C and hence is more portable.

BUGS
       This function suffers from the same problems as strtok().  In  particu-
       lar, it modifies	the original string. Avoid it.

CONFORMING TO
       BSD 4.4

SEE ALSO
       index(3),   memchr(3),  rindex(3),  strchr(3),  strpbrk(3),  strspn(3),
       strstr(3), strtok(3)

GNU				  1993-04-12			     STRSEP(3)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | NOTES | BUGS | CONFORMING TO | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=strsep&sektion=3&manpath=Red+Hat+Linux%2fi386+9>

home | help