Subversion Repositories Kolibri OS

/*

FUNCTION

	<>, <>, <>---get next token from a string

INDEX

	strtok

INDEX

	strtok_r

INDEX

	strsep

ANSI_SYNOPSIS

	#include 

      	char *strtok(char *restrict <[source]>,

                     const char *restrict <[delimiters]>)

      	char *strtok_r(char *restrict <[source]>,

                       const char *restrict <[delimiters]>,

                       char **<[lasts]>)

      	char *strsep(char **<[source_ptr]>, const char *<[delimiters]>)

TRAD_SYNOPSIS

	#include 

	char *strtok(<[source]>, <[delimiters]>)

	char *<[source]>;

	char *<[delimiters]>;

	char *strtok_r(<[source]>, <[delimiters]>, <[lasts]>)

	char *<[source]>;

	char *<[delimiters]>;

	char **<[lasts]>;

	char *strsep(<[source_ptr]>, <[delimiters]>)

	char **<[source_ptr]>;

	char *<[delimiters]>;

DESCRIPTION

	The <> function is used to isolate sequential tokens in a

	null-terminated string, <<*<[source]>>>. These tokens are delimited

	in the string by at least one of the characters in <<*<[delimiters]>>>.

	The first time that <> is called, <<*<[source]>>> should be

	specified; subsequent calls, wishing to obtain further tokens from

	the same string, should pass a null pointer instead.  The separator

	string, <<*<[delimiters]>>>, must be supplied each time and may

	change between calls.

	The <> function returns a pointer to the beginning of each

	subsequent token in the string, after replacing the separator

	character itself with a null character.  When no more tokens remain,

	a null pointer is returned.

	The <> function has the same behavior as <>, except

	a pointer to placeholder <<*<[lasts]>>> must be supplied by the caller.

	The <> function is similar in behavior to <>, except

	a pointer to the string pointer must be supplied <<<[source_ptr]>>> and

	the function does not skip leading delimiters.  When the string starts

	with a delimiter, the delimiter is changed to the null character and

	the empty string is returned.  Like <> and <>, the

	<<*<[source_ptr]>>> is updated to the next character following the

	last delimiter found or NULL if the end of string is reached with

	no more delimiters.

RETURNS

	<>, <>, and <> all return a pointer to the

	next token, or <> if no more tokens can be found.  For

	<>, a token may be the empty string.

NOTES

	<> is unsafe for multi-threaded applications.  <>

	and <> are thread-safe and should be used instead.

PORTABILITY

<> is ANSI C.

<> is POSIX.

<> is a BSD extension.

<>, <>, and <> require no supporting OS subroutines.

QUICKREF

	strtok ansi impure

*/

/* undef STRICT_ANSI so that strtok_r prototype will be defined */

#undef  __STRICT_ANSI__

#include 

#include <_ansi.h>

#include 

#ifndef _REENT_ONLY

extern char *__strtok_r (char *, const char *, char **, int);

char *

_DEFUN (strtok, (s, delim),

	register char *__restrict s _AND

	register const char *__restrict delim)

{

	struct _reent *reent = _REENT;

	_REENT_CHECK_MISC(reent);

	return __strtok_r (s, delim, &(_REENT_STRTOK_LAST(reent)), 1);

}

#endif