База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C

strtok — разделяне на низ на токени

strtok разделя променяем низ на непразни токени, като презаписва разделителите и запомня откъде да продължи.

Версия: C23; repository compiler flag, production runtime not attested

Синтаксис

#include <string.h>
char *strtok(char * restrict s1, const char * restrict s2);

strtok от <string.h> третира s2 като множество от разделителни знаци, а не като подниз. Пропуска началните и повтарящите се разделители: празни токени не се създават.

При първото извикване подайте променяем низ, завършващ с нулев знак; при следващите извиквания подайте NULL като s1. s2 може да се променя между извикванията. Резултатът сочи към токен в оригиналния масив или е NULL, когато не са останали токени.

Разделителят, който завършва токена, се заменя с '\0'. Никога не подавайте низов литерал; направете копие на входа, ако трябва да го запазите.

Запазеното състояние не позволява преплитане на независими разделяния на токени. Продължаването на поредица в друга нишка води до неопределено поведение. Примерът пропуска повтарящите се разделители.

Примери

#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;
}

Резултат

red
green
blue

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници