URL
https://opencores.org/ocsvn/openrisc_me/openrisc_me/trunk
Subversion Repositories openrisc_me
[/] [openrisc/] [trunk/] [gnu-src/] [newlib-1.18.0/] [newlib/] [libc/] [string/] [strtok.c] - Rev 307
Go to most recent revision | Compare with Previous | Blame | View Log
/* 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
Go to most recent revision | Compare with Previous | Blame | View Log