Функции библиотеки C -strtok()

Стандартная библиотека C - <string.h>

strtok() — это функция обработки строк в стандартной библиотеке C, используемая для разбиения строки на ряд подстрок (то есть «токенов»).

Функции библиотеки Cchar *strtok(char *str, const char *delim)Разделить строкуstrДля набора строк,delimв качестве разделителя.

Объявление

Ниже приведено объявление функции strtok().

char *strtok(char *str, const char *delim)

Параметр

  • str: строка для разбиения. При первом вызове передайте строку для разбиения; при последующих вызовах передайтеNULL, указывая на необходимость продолжать разбиение той же строки.

  • delim: строка-разделитель.strtok()будет разбивать по любому символу из этой строки.str。

Возвращаемое значение

Возвращает указатель на следующий токен. Если токенов больше нет, возвращает NULL.

Пример

В следующем примере демонстрируется использование функции strtok().

Пример

#include <string.h> #include <stdio.h> int main () { char str[80] = "This is - www.example.com - website"; const char s[2] = "-"; char *token; /*Получить первую подстроку*/ token = strtok(str, s); /*Продолжить получение остальных подстрок*/ while( token != NULL ) { printf( "%s\n", token ); token = strtok(NULL, s); } return(0); }

Давайте скомпилируем и запустим приведённую выше программу, которая выдаст следующий результат:

This is 
 www.example.com 
 website

Примечания

  1. Изменяет исходную строку: strtok()изменит переданную строку, заменив разделители на\0(нулевой символ). Следовательно, исходная строка будет уничтожена.

  2. Нереентерабельный: strtok()Использует статический буфер для сохранения состояния, поэтому не является потокобезопасным. При использовании в многопоточной среде рассмотрите использованиеstrtok_r()(реентерабельная версия).

  3. Подряд идущие разделители: если в строке есть подряд идущие разделители,strtok()проигнорирует их и вернёт следующий допустимый токен.


Реентерабельная версия: strtok_r()

strtok_r() — это реентерабельная версия strtok(), которая позволяет безопасно использовать её в многопоточных средах. Её прототип выглядит следующим образом:

char *strtok_r(char *str, const char *delim, char **saveptr);

saveptr: это указатель на char*, используемый для сохранения состояния разбиения.

Пример

#include <stdio.h>
#include <string.h>

int main() {
    char str[] = "This is a sample string";
    char *token;
    char *saveptr;

    // Первый вызов strtok_r, передавая строку для разделения
    token = strtok_r(str, " ", &saveptr);

    // Продолжайте вызывать strtok_r, пока она не вернёт NULL
    while (token != NULL) {
        printf("%s\n", token);
        token = strtok_r(NULL, " ", &saveptr);
    }

    return 0;
}

strtok() — удобная функция разделения строк, но нужно учитывать её побочные эффекты (изменение исходной строки) и нереентерабельность. В многопоточных средах рекомендуется использовать strtok_r(), чтобы избежать состояний гонки.

Стандартная библиотека C - <string.h>

Другие расширения