strsep(3STDC)

NAME | SYNOPSIS | API RESTRICTIONS | DESCRIPTION | ATTRIBUTES

NAME

strsep- separate strings

SYNOPSIS

#include <string.h>

char *strsep(char **sp, const char *d);

API RESTRICTIONS

The function or functions documented here may not be used safely in all application contexts with all APIs provided in the ChorusOS 5.0 product.

See API(5FEA) for details.

DESCRIPTION

The strsep() function locates, in the string referenced by *sp, the first occurrence of any character in the string d (or the terminating null 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 *sp The original value of *sp is returned.

An ``empty'' field caused by two adjacent delimiter characters, can be detected by comparing the location referenced by the pointer returned in *sp to 0.

If *sp is initially NULL, strsep returns NULL.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Evolving

NAME | SYNOPSIS | API RESTRICTIONS | DESCRIPTION | ATTRIBUTES