strtok, _strtok_l, wcstok, _wcstok_l, _mbstok, _mbstok_l

Článek
03/26/2013

Najděte další token řetězce pomocí aktuální národní prostředí nebo zadané národní prostředí předána.Bezpečnější verze tyto funkce jsou k dispozici; see strtok_s, _strtok_s_l, wcstok_s, _wcstok_s_l, _mbstok_s, _mbstok_s_l.

Důležité
_mbstoka _mbstok_l nelze použít v aplikacích, které jsou spuštěny v systému 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
Chcete-li národní prostředí pro použití.

Vrácená hodnota

Vrací ukazatel na další token, který v strToken.Vracejí NULL Pokud jsou nalezeny žádné další tokeny.Každé volání upravuje strToken nahrazením NULL znak pro první oddělovač, ke kterému dochází po výsledný token.

Poznámky

strtok Funkce vyhledá další token, který v strToken.Sada znaků v strDelimit Určuje možné oddělovače token lze nalézt v strToken na aktuální volání.wcstoka _mbstok jsou verze širokého znaku a vícebajtové znakové sady strtok.Argumenty a vrácené hodnoty wcstok jsou řetězci širokého znaku; u _mbstok jsou vícebajtové znakové řetězce.Tyto tři funkce chovat identicky jinak.

Poznámka k zabezpečení
Tyto funkce při rozloženém potenciální ohrožení vyvolaných problému přetečení vyrovnávací paměti.Přetečení vyrovnávací paměti potíže jsou používaný způsob útoku systému, výsledkem bude vyplacena neoprávněně zvýšení úrovně oprávnění.Další informace naleznete v tématu Zamezení způsobí přetečení vyrovnávací paměti.

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

Výstupní hodnota je ovlivněna nastavením LC_CTYPE kategorie nastavení národního prostředí; Viz setlocale pro další informace.Verze těchto funkcí, aniž by _l příponu použít aktuální národní prostředí pro toto chování závislé na národním prostředí; verze s _l s tím rozdílem, že používají místo něho předán parametr locale shodná přípona.Další informace naleznete v tématu Národní prostředí.

[!POZNÁMKA]

Každá funkce používá místní statické 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 rámci jednoho podprocesu prokládání volání některou z těchto funkcí je však velmi pravděpodobné, že poškození dat a nepřesné výsledky.Při analýze různé řetězce dokončete předtím, než začnete analyzovat další analýza jednoho řetězce.Navíc znát potenciální nebezpečí při volání některou z těchto funkcí z uvnitř smyčky, kde se nazývá jinou funkci.Jiné funkce skončilo, pomocí jedné z těchto funkcí, prokládaném posloupnost volání způsobíte, který spouští poškození dat.

Mapování rutiny obecného textu

TCHAR.Byla zahájena rutina h	_UNICODE & _MBCS není definováno	_MBCS, definice	_UNICODE definována
_tcstok	strtok	_mbstok	wcstok
_tcstok	_strtok_l	_mbstok_l	_wcstok_l

Požadavky

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

Další informace o kompatibilitě, viz Compatibility v úvodu.

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