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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.