strtok_r(3) strtok_r(3)
NAME
strtokr - Zeichenkette in Tokens aufteilen
SYNTAX
#include <string.h>
char *strtokr(char *s, const char *sep, char **lasts);
BESCHREIBUNG
Die Funktion strtokr() ist die thread-sichere Version von strtok().
Die Funktion strtokr() verarbeitet die auf Null endende Zeichenkette
s als eine Folge aus null oder mehr Texttokens, die durch ein oder
mehrere Zeichen aus der Trennzeichenfolge sep getrennt sind. Das Argu-
ment lasts zeigt auf einen vom Benutzer angegebenen Zeiger, der auf
gespeicherte Informationen zeigt, die für eine Fortsetzung der Suche
in derselben Zeichenkette benötigt werden.
Im ersten Aufruf von strtokr() zeigt s auf eine Zeichenkette mit
Endenull, sep auf eine Zeichenkette mit Endenull aus Trennzeichen und
der Wert, auf den lasts zeigt, wird ignoriert. Die Funktion strtokr()
gibt einen Zeiger auf das erste Zeichen des ersten Token zurück,
schreibt ein Null-Zeichen in die Zeichenkette s, die direkt auf den
zurückgegebenen Token folgt, und aktualisiert den Zeiger, auf den
lasts zeigt.
Im nachfolgenden Aufruf ist s ein NULL-Zeiger und lasts bleibt vom
vorherigen Aufruf unverändert, so daß nachfolgende Aufrufe die Zei-
chenkette s bearbeiten und so lange aufeinanderfolgende Tokens zurück-
geben, bis keine Tokens mehr vorliegen. Die Trennzeichenkette sep kann
von Aufruf zu Aufruf variieren. Wenn s keine Tokens mehr enthält, wird
ein NULL-Zeiger zurückgegeben.
RÜCKGABEWERTE
Die Funktion strtokr() gibt einen Zeiger auf das gefundene Token oder
- wenn kein Token gefunden wird - einen NULL-Zeiger zurück.
FEHLER
Es sind keine Fehler definiert.
SIEHE AUCH
strtok(3C), string(5).
Seite 1 Reliant UNIX 5.44 Gedruckt 11/98