Your Browser is not longer supported
Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...
{{viewport.spaceProperty.prod}}
strtok - Zeichenkette in Tokens zerlegen
&pagelevel(4)&pagelevel
Definition | #include <string.h> char * strtok(char *s1, const char *s2); |
Beschreibung | Mit strtok() lässt sich eine Gesamtzeichenkette s1 in Teilzeichenketten – sog. "Tokens" – zerlegen, z.B. ein Satz in die einzelnen Wörter oder eine Quellprogrammanweisung in die kleinsten syntaktischen Einheiten. Der Zeiger auf s1 darf nur beim ersten strtok -Aufruf übergeben werden. Ab dem zweiten Aufruf ist ein Nullzeiger anzugeben. Beginn- und Endekriterium für jedes Token sind Trennzeichen (Separatoren), die in einer zweiten Zeichenkette s2 anzugeben sind. Tokens können durch einen oder mehrere dieser Separatoren bzw. durch Beginn und Ende der Gesamtzeichenkette s1 begrenzt sein. Typische Separatoren zwischen den Wörtern eines Satzes sind z.B. Leerzeichen, Doppelpunkt, Komma etc. Pro Aufruf bearbeitet strtok() genau eine Teilzeichenkette. Der erste Aufruf liefert einen Zeiger auf den Beginn der ersten gefundenen Teilzeichenkette, die weiteren Aufrufe jeweils einen Zeiger auf den Beginn der nächsten Teilzeichenketten. Jede Teilzeichenkette schließt strtok() mit dem Nullbyte (\0 ) ab. Bei jedem Aufruf kann eine andere Trennzeichenfolge s2 angegeben werden. strtok() ist nicht threadsicher. Verwenden Sie bei Bedarf die reentrante Funktion strtok_r() .
|
Returnwert | Zeiger auf den Beginn einer Teilzeichenkette |
|
| Beim ersten Aufruf ein Zeiger auf die erste Teilzeichenkette, beim nächsten Aufruf ein Zeiger auf die nachfolgende Teilzeichenkette etc. strtok() schließt jede Teilzeichenkette in s1 mit einem Nullbyte (\0 ) ab, wobei das jeweils erste gefundene Trennzeichen mit dem Nullbyte (\0 ) überschrieben wird. |
| Nullzeiger | falls keine bzw. keine weitere Teilzeichenkette gefunden wurde. |
Siehe auch | string.h ., strtok_r() .
|