upload sdk

git-svn-id: svn://kolibrios.org@4349 a494cfbc-eb01-0410-851d-a64ba20cac60

contrib/sdk/sources/newlib/string/strtok.c

@@ -0,0 +1,101 @@
+/*
+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