CKTIS / C
strtok — een tekenreeks in tokens splitsen
strtok splitst een wijzigbare tekenreeks in niet-lege tokens, overschrijft scheidingstekens en onthoudt waar het verder moet gaan.
Versie: C23; repository compiler flag, production runtime not attested
Syntax
#include <string.h>
char *strtok(char * restrict s1, const char * restrict s2);strtok uit <string.h> behandelt s2 als een verzameling scheidingstekens, niet als een deelreeks. Voorafgaande en herhaalde scheidingstekens worden overgeslagen: er ontstaan geen lege tokens.
Geef bij de eerste aanroep een wijzigbare, nulbeëindigde tekenreeks door; geef bij volgende aanroepen NULL door als s1. s2 mag tussen aanroepen veranderen. Het resultaat verwijst naar een token in de oorspronkelijke array, of is NULL als er geen tokens meer zijn.
Het scheidingsteken aan het einde van een token wordt vervangen door '\0'. Geef nooit een tekenreeksliteral door; maak een kopie van de invoer als u die wilt behouden.
De opgeslagen toestand voorkomt dat onafhankelijke tokenisaties door elkaar lopen. Een reeks voortzetten in een andere thread leidt tot ongedefinieerd gedrag. Het voorbeeld slaat herhaalde scheidingstekens over.
Voorbeelden
#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;
}
Resultaat
red green blue
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.