CKTIS / C
strtok — eine Zeichenkette in Tokens aufteilen
strtok teilt eine veränderbare Zeichenkette in nicht leere Tokens auf, indem es Trennzeichen überschreibt und die Position für die Fortsetzung speichert.
Version: C23; repository compiler flag, production runtime not attested
Syntax
#include <string.h>
char *strtok(char * restrict s1, const char * restrict s2);strtok aus <string.h> behandelt s2 als Menge von Trennzeichen, nicht als Teilzeichenkette. Führende und wiederholte Trennzeichen werden übersprungen: Leere Tokens entstehen nicht.
Übergeben Sie beim ersten Aufruf eine veränderbare, nullterminierte Zeichenkette und bei den folgenden Aufrufen NULL als s1. s2 darf zwischen Aufrufen geändert werden. Das Ergebnis zeigt auf ein Token im ursprünglichen Array oder ist NULL, wenn keine Tokens mehr vorhanden sind.
Das Trennzeichen am Ende eines Tokens wird durch '\0' ersetzt. Übergeben Sie niemals ein Stringliteral; kopieren Sie die Eingabe, wenn Sie sie unverändert benötigen.
Der gespeicherte Zustand verhindert, dass unabhängige Tokenisierungen ineinander verschachtelt werden. Das Fortsetzen einer Folge in einem anderen Thread führt zu undefiniertem Verhalten. Das Beispiel überspringt wiederholte Trennzeichen.
Beispiele
#include <stdio.h>
#include <string.h>
int main(void)
{
char text[] = ",red;;green,blue,";
char *token = strtok(text, ",;");
while (token != NULL) {
puts(token);
token = strtok(NULL, ",;");
}
return 0;
}
Ergebnis
red green blue
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.