Subversion Repositories openrisc_me

/*

FUNCTION

        <<strtok>>, <<strtok_r>>, <<strsep>>---get next token from a string

INDEX

        strtok

INDEX

        strtok_r

INDEX

        strsep

ANSI_SYNOPSIS

        #include <string.h>

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

        char *strtok_r(char *<[source]>, const char *<[delimiters]>,

                        char **<[lasts]>)

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

TRAD_SYNOPSIS

        #include <string.h>

        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 <<strtok>> 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 <<strtok>> 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 <<strtok>> 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 <<strtok_r>> function has the same behavior as <<strtok>>, except

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

        The <<strsep>> function is similar in behavior to <<strtok>>, 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 <<strtok_r>> and <<strtok>>, 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

        <<strtok>>, <<strtok_r>>, and <<strsep>> all return a pointer to the

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

        <<strsep>>, a token may be the empty string.

NOTES

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

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

PORTABILITY

<<strtok>> is ANSI C.

<<strtok_r>> is POSIX.

<<strsep>> is a BSD extension.

<<strtok>>, <<strtok_r>>, and <<strsep>> require no supporting OS subroutines.

QUICKREF

        strtok ansi impure

*/

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

#undef  __STRICT_ANSI__

#include <string.h>

#include <_ansi.h>

#include <reent.h>

#ifndef _REENT_ONLY

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

char *

_DEFUN (strtok, (s, delim),

        register char *s _AND

        register const char *delim)

{

        _REENT_CHECK_MISC(_REENT);

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

}

#endif