mirror of
git://sourceware.org/git/newlib-cygwin.git
synced 2025-01-18 12:29:32 +08:00
d4dca0e42e
* libc/include/sys/reent.h (_REENT_INIT_PTR): New macro for
initializing a struct _reent that has been dynamically allocated.
(_REENT_CHECK_MISC): New macro that checks _misc struct for
_REENT_SMALL and does nothing otherwise.
(_REENT_STRTOK_LAST): New macro for reentrant strtok.
(_REENT_MBLEN_STATE): New macro for reentrant mblen.
(_REENT_MBTOWC_STATE): New macro for reentrant mbtowc.
(_REENT_WCTOMB_STATE): New macro for reentrant wctomb.
[_REENT_SMALL](struct _misc_reent): New structure containing
miscellaneous reentrant areas needed by newlib.
[_REENT_SMALL](struct _reent): Add _misc pointer.
[_REENT_SMALL](_REENT_INIT_MISC): New macro.
* libc/string/strtok (strtok): Change to use _REENT_CHECK_MISC
and _REENT_STRTOK_LAST macros.
* libc/stdlib/mblen (mblen): Change to use _REENT_CHECK_MISC
and _REENT_MBLEN_STATE macros.
* libc/stdlib/mbtowc (mbtowc): Change to use _REENT_CHECK_MISC
and _REENT_MBTOWC_STATE macros.
* libc/stdlib/wctomb (wctomb): Change to use _REENT_CHECK_MISC
and _REENT_WCTOMB_STATE macros.
80 lines
2.1 KiB
C
80 lines
2.1 KiB
C
/*
|
|
FUNCTION
|
|
<<strtok>>---get next token from a string
|
|
|
|
INDEX
|
|
strtok
|
|
|
|
INDEX
|
|
strtok_r
|
|
|
|
ANSI_SYNOPSIS
|
|
#include <string.h>
|
|
char *strtok(char *<[source]>, const char *<[delimiters]>)
|
|
char *strtok_r(char *<[source]>, const char *<[delimiters]>,
|
|
char **<[lasts]>)
|
|
|
|
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]>;
|
|
|
|
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 NUL 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.
|
|
|
|
RETURNS
|
|
<<strtok>> returns a pointer to the next token, or <<NULL>> if
|
|
no more tokens can be found.
|
|
|
|
NOTES
|
|
<<strtok>> is unsafe for multi-thread applications. <<strtok_r>>
|
|
is MT-Safe and should be used instead.
|
|
|
|
PORTABILITY
|
|
<<strtok>> is ANSI C.
|
|
|
|
<<strtok>> requires 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
|
|
|
|
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)));
|
|
}
|
|
#endif
|