strtok, strtok_s

Tokenisiert einen nullterminierten Byte-String.

1. ↑ Ein Token kann in einem nachfolgenden Aufruf mit einer anderen Trennzeichenkette weiterhin gebildet werden.
2. ↑ In nachfolgenden Aufrufen können keine weiteren Tokens mehr gebildet werden.

Parameter

Rückgabewert

Hinweis

Diese Funktion ist destruktiv: sie schreibt die ' \0 ' Zeichen in die Elemente des Strings str . Insbesondere kann ein String-Literal nicht als erstes Argument von strtok verwendet werden.

Jeder Aufruf von strtok modifiziert eine statische Variable: ist nicht threadsicher.

Im Gegensatz zu den meisten anderen Tokenizern können die Trennzeichen in strtok für jeden nachfolgenden Token unterschiedlich sein und können sogar von den Inhalten der vorherigen Token abhängen.

Die strtok_s -Funktion unterscheidet sich von der POSIX- strtok_r -Funktion dadurch, dass sie vor dem Speichern außerhalb des zu tokenisierenden Strings schützt und Laufzeitbeschränkungen überprüft. Die Microsoft CRT- strtok_s -Signatur entspricht dieser POSIX- strtok_r -Definition, nicht der C11- strtok_s -Definition.

Beispiel

#define __STDC_WANT_LIB_EXT1__ 1
#include <stdio.h>
#include <string.h>
int main(void)
{
    char input[] = "A bird came down the walk";
    printf("Parsing the input string '%s'\n", input);
    char* token = strtok(input, " ");
    while (token)
    {
        puts(token);
        token = strtok(NULL, " ");
    }
    printf("Contents of the input string now: '");
    for (size_t n = 0; n < sizeof input; ++n)
        input[n] ? putchar(input[n]) : fputs("\\0", stdout);
    puts("'");
#ifdef __STDC_LIB_EXT1__
    char str[] = "A bird came down the walk";
    rsize_t strmax = sizeof str;
    const char* delim = " ";
    char* next_token;
    printf("Parsing the input string '%s'\n", str);
    token = strtok_s(str, &strmax, delim, &next_token);
    while (token)
    {
        puts(token);
        token = strtok_s(NULL, &strmax, delim, &next_token);
    }
    printf("Contents of the input string now: '");
    for (size_t n = 0; n < sizeof str; ++n)
        str[n] ? putchar(str[n]) : fputs("\\0", stdout);
    puts("'");
#endif
}

Parsing the input string 'A bird came down the walk'
A
bird
came
down
the
walk
Contents of the input string now: 'A\0bird\0came\0down\0the\0walk\0'
Parsing the input string 'A bird came down the walk'
A
bird
came
down
the
walk
Contents of the input string now: 'A\0bird\0came\0down\0the\0walk\0'

Referenzen

Siehe auch