strtok, _strtok_l, wcstok, _wcstok_l, _mbstok, _mbstok_l

Článek
06/09/2015

Najde další token pomocí národního prostředí aktuální nebo zadané národní prostředí, který je předán do řetězce.Bezpečnější verze těchto funkcí jsou k dispozici; viz strtok_s, _strtok_s_l, wcstok_s, _wcstok_s_l, _mbstok_s, _mbstok_s_l.

Důležité
_mbstok a _mbstok_l nelze použít v aplikacích, které jsou spouštěny v modulu Windows Runtime.Další informace naleznete v tématu CRT funkce nejsou podporovány s /ZW.

char *strtok(
   char *strToken,
   const char *strDelimit 
);
wchar_t *wcstok(
   wchar_t *strToken,
   const wchar_t *strDelimit 
);
unsigned char *_mbstok(
   unsigned char*strToken,
   const unsigned char *strDelimit 
);
unsigned char *_mbstok(
   unsigned char*strToken,
   const unsigned char *strDelimit,
   _locale_t locale
);

Parametry

strToken
Řetězec obsahující token nebo tokeny.
strDelimit
Sada znaků oddělovače.
locale
Použité národní prostředí.

Vrácená hodnota

Vrací ukazatel na další token v strToken.Vrátit NULL Pokud jsou nalezeny žádné další tokeny.Upraví každé volání strToken nahrazením NULL znak pro oddělovač první po výsledný token.

Poznámky

strtok Funkce vyhledá další token v strToken.Sadu znaků v strDelimit Určuje možné oddělovače v tokenu lze nalézt v strToken na aktuální volání.wcstok a _mbstok jsou širokoznaká verze a vícebajtová znaková verze strtok.Argumenty a vrácené hodnoty wcstok jsou širokoznaké řetězce. Hodnoty _mbstok jsou vícebajtové znakové řetězce.Tyto tři funkce se chovají identicky jinak.

Poznámka k zabezpečení
Tyto funkce jsou vystaveni potenciální ohrožení způsobené problému přetečení vyrovnávací paměti.Problémy s přetečením vyrovnávací paměti jsou častou metodou útoku na systém. Výsledkem je negarantované zvýšení úrovně oprávnění.Další informace naleznete v tématu Předcházení přetečení vyrovnávací paměti.

Při prvním volání strtok, funkce Přeskočí úvodní oddělovače a vrací ukazatel na první token v strToken, ukončení token znakem null.Další tokeny lze zjistit z zbytek strToken řadou volání strtok.Každé volání strtok upravuje strToken znak null po vložení token vrácené toto volání.Číst další token z strToken, volání strtok se NULL hodnotu pro strToken argument.NULLstrToken Argument způsobí, že strtok Chcete-li vyhledat další token v upravenou strToken. strDelimit Argument může nabývat hodnot od jedno volání na další, takže sada oddělovačů se mohou lišit.

Výstupní hodnota je ovlivněna nastavením kategorie LC_CTYPE národního prostředí; viz setlocale pro další informace.Verze těchto funkcí bez přípony _l používají aktuální národní prostředí pro toto chování závislé na národním prostředí. Verze s příponou _l jsou stejné s tím rozdílem, že používají předaný parametr národního prostředí.Další informace naleznete v tématu Národní prostředí.

[!POZNÁMKA]

Každá funkce používá statické místní proměnné pro analýzu řetězce do tokenů.Proto více vláken současně volat tyto funkce, bez nežádoucích účinků.V jednom vlákně folií při volání na některou z těchto funkcí je však vysoce pravděpodobné poškození dat a nepřesné výsledky.Při analýze různých řetězců, dokončete předtím, než začnete analyzovat další analýza jednoho řetězce.Také být vědomi potenciální nebezpečí při volání některou z těchto funkcí od uvnitř smyčky, kde jiné funkce je volána.Pokud ostatní funkce skončilo, pomocí jedné z těchto funkcí, budou výsledkem prokládaném sekvenci volání, aktivaci poškození dat.

Rutinní mapování obecného textu

Rutina TCHAR.H	_UNICODE & _MBCS není definováno	_MBCS definováno	_UNICODE definováno
_tcstok	strtok	_mbstok	wcstok
_tcstok	_strtok_l	_mbstok_l	_wcstok_l

Požadavky

Rutina	Požadované záhlaví
strtok	<string.h>
wcstok	<string.h> nebo <wchar.h>
_mbstok, _mbstok_l	<mbstring.h>

Další informace o kompatibilitě naleznete v tématu Kompatibilita.

Příklad

// crt_strtok.c
// compile with: /W3
// In this program, a loop uses strtok
// to print all the tokens (separated by commas
// or blanks) in the string named "string".
//
#include <string.h>
#include <stdio.h>

char string[] = "A string\tof ,,tokens\nand some  more tokens";
char seps[]   = " ,\t\n";
char *token;

int main( void )
{
   printf( "Tokens:\n" );
 
   // Establish string and get the first token:
   token = strtok( string, seps ); // C4996
   // Note: strtok is deprecated; consider using strtok_s instead
   while( token != NULL )
   {
      // While there are tokens in "string"
      printf( " %s\n", token );

      // Get next token: 
      token = strtok( NULL, seps ); // C4996
   }
}