mirror of
git://sourceware.org/git/newlib-cygwin.git
synced 2025-01-15 19:09:58 +08:00
239c2bf93e
* libc/misc/unctrl.c: Replace FUNCTION description.
* libc/signal/signal.c: Remove documentation for raise and _raise_r.
* libc/stdio/getdelim.c: Fix spelling errors.
* libc/stdio/getw.c: Put RETURNS on a separate line. Fix punctuation.
* libc/stdio/putw.c: Likewise.
* libc/stdlib/a64l.c: Fix formatting, spelling and punctuation in
documentation.
* libc/stdlib/assert.c: Do not capitalize FUNCTION description.
* libc/stdlib/efgcvt.c: Add spaces to FUNCTION description.
* libc/stdlib/envlock.c: Use em-dash in FUNCTION description.
* libc/stdlib/mlock.c: Likewise.
* libc/stdlib/mstats.c: Likewise.
* libc/time/tzlock.c: Likewise.
* libc/stdlib/rand.c: Use "multi-threaded" and "thread-safe" in NOTES.
* libc/stdlib/rand48.c: Remove extra space in FUNCTION description
and hyphenate "pseudo-random".
* libc/string/bcmp.c: Remove extra blank lines in documentation.
* libc/string/strncat.c: Likewise.
* libc/string/memchr.c: Remove extra ">" character in documentation.
* libc/string/strcspn.c: Use "characters" instead of "chars".
* libc/string/strpbrk.c: Likewise.
* libc/string/strerror_r.c: Capitalize "GNU".
* libc/string/strnlen.c: Likewise.
* libc/string/strtok.c: Fix formatting, spelling and punctuation in
documentation. Use "multi-threaded" and "thread-safe" in NOTES.
* libc/string/wcscat.c: Split PORTABILITY into two paragraphs.
* libc/string/wcschr.c: Likewise.
* libc/string/wcscmp.c: Likewise.
* libc/string/wcscpy.c: Likewise.
* libc/string/wcscspn.c: Likewise.
* libc/string/wcslen.c: Likewise.
* libc/string/wcsncat.c: Likewise.
* libc/string/wcsncmp.c: Likewise.
* libc/string/wcsncpy.c: Likewise.
* libc/string/wcsnlen.c: Likewise.
* libc/string/wcspbrk.c: Likewise.
* libc/string/wcsrchr.c: Likewise.
* libc/string/wcsspn.c: Likewise.
* libc/string/wmemchr.c: Likewise.
* libc/string/wmemcmp.c: Likewise.
* libc/string/wmemcpy.c: Likewise.
* libc/string/wmemset.c: Likewise.
* libc/string/wmemmove.c: Likewise. Also fix FUNCTION description.
* libc/string/wcswidth.c: Formatting and punctuation in documentation.
* libc/string/wcwidth.c: Likewise.
* libm/common/s_modf.c: Remove extra period from documentation.
* libm/math/s_isnan.c: Fix formatting, grammar and punctuation in
documentation.
* libm/mathfp/s_isnan.c: Likewise.
* libm/math/s_ldexp.c: Fix punctuation.
* libm/mathfp/s_ldexp.c: Likewise.
* libm/math/w_log.c: Likewise.
* libm/mathfp/s_logarithm.c: Likewise.
* libm/math/w_j0.c: Add spaces to FUNCTION description.
* libm/mathfp/w_jn.c: Likewise.
102 lines
3.0 KiB
C
102 lines
3.0 KiB
C
/*
|
|
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
|