strsep man page on 4.4BSD

Man page or keyword search:  
man Server   1065 pages
apropos Keyword Search (all sections)
Output format
4.4BSD logo
[printable version]

STRSEP(3)		 BSD Library Functions Manual		     STRSEP(3)

NAME
     strsep — separate strings

SYNOPSIS
     #include <string.h>

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

DESCRIPTION
     The strsep() function locates, in the string referenced by *stringp, the
     first occurrence of any character in the string delim (or the terminating
     ‘\0’ character) and replaces it with a ‘\0’.  The location of the next
     character after the delimiter character (or NULL, if the end of the
     string was reached) is stored in *stringp.	 The original value of
     *stringp is returned.

     An ``empty'' field, i.e. one caused by two adjacent delimiter characters,
     can be detected by comparing the location referenced by the pointer
     returned in *stringp to ‘\0’.

     If *stringp is initially NULL, strsep() returns NULL.

EXAMPLES
     The following uses strsep() to parse a string, containing tokens delim‐
     ited by white space, into an argument vector:

	   char **ap, *argv[10], *inputstring;

	   for (ap = argv; (*ap = strsep(&inputstring, " \t")) != NULL;)
		   if (**ap != '\0')
			   ++ap;

HISTORY
     The strsep() function is intended as a replacement for the strtok() func‐
     tion.  While the strtok() function should be preferred for portability
     reasons (it conforms to ANSI X3.159-1989 (“ANSI C89”)) it is unable to
     handle empty fields, i.e. detect fields delimited by two adjacent delim‐
     iter characters, or to be used for more than a single string at a time.
     The strsep() function first appeared in 4.4BSD.

BSD				 June 9, 1993				   BSD
[top]

List of man pages available for 4.4BSD

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net