strtok、 _strtok_l、 wcstok、 _wcstok_l、 _mbstok、 _mbstok_l

發行項
03/27/2013

尋找字串中的下一個語彙基元，並使用目前的地區設定或指定的地區設定。更多這些函式的可用安全版本，請參閱 strtok_s、 _strtok_s_l、 wcstok_s、 _wcstok_s_l、 _mbstok_s、 _mbstok_s_l 。

重要事項
_mbstok 和 _mbstok_l 不能用於 Windows 執行階段執行的應用程式。如需詳細資訊，請參閱 CRT 函式不支援使用 /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
);

參數

strToken
包含語彙基元或語彙基元的字串。
strDelimit
一組分隔符號字元。
locale
使用的地區設定。

傳回值

將指標傳回在 strToken中的下一個語彙基元。當找不到時，會傳回 NULL 沒有其他語彙基元。每個呼叫會將替代 NULL 字元修改 strToken 中第一個符號的發生在這個傳回的語彙基元之後。

備註

strtok 函式會出現在 strToken的下一個語彙基元。集合中 strDelimit 的字元指定在目前呼叫中的 strToken 中找到的權杖的符號。wcstok 和 _mbstok 是 strtok 的寬字元和多位元組字元版本。wcstok 的參數和回傳值是寬字元字串，而 _mbstok 則是多位元組字元字串。這三個函式其餘部分的運作相同。

安全性提示
這些函式有導致緩衝區溢位問題的潛在威脅。緩衝區溢位問題是系統攻擊的常見方法，它會導致權限不確定性的增加。如需詳細資訊，請參閱 Avoiding Buffer Overruns 。

在對 strtok的呼叫，則函式會跳前置正負號並傳回指標至 strToken的第一個語彙基元，是以 null 字元的語彙基元。多個語彙基元可以開啟 strToken 餘數由對 strtok的一系列的呼叫。對 strtok的每個呼叫都會透過插入 null 字元修改 strToken 在該呼叫傳回的 token 。要讀取 strToken的下一個語彙基元，請改為使用 NULL 值的 strtokstrToken 引數的。NULLstrToken 引數造成 strtok 搜尋已修改 strToken的下一個語彙基元。strDelimit 引數可以接受來自呼叫的任何值到下，以便組符號可以變更。

輸出值受地區設定的LC_CTYPE 分類設定所影響。如需詳細資訊，請參閱 setlocale 。這些函式沒有以 _l 後綴的版本在這些地區相依的行為上使用目前的地區設定，而以 _l 後綴版本除了它們會使用傳入的地區設定參數之外運作相同。如需詳細資訊，請參閱地區設定。

注意事項
每個函式為剖析字串使用執行緒區域靜態變數語彙基元。因此，多個執行緒可以同時呼叫這些函式，而不想要的效果。不過，在單一執行緒內容，交錯呼叫這些函式之一是很可能會導致資料損毀和不正確的結果。當剖析不同字串，剖析之字串的結尾開始前解析下。此外，請注意在危險的可能性，呼叫這些函式之一從另一個函式呼叫的迴圈內時。使用這些函式之一，如果其他函式的結果，呼叫的交錯順序，否則會發生觸發資料毀損。

每個函式為剖析字串使用執行緒區域靜態變數語彙基元。因此，多個執行緒可以同時呼叫這些函式，而不想要的效果。不過，在單一執行緒內容，交錯呼叫這些函式之一是很可能會導致資料損毀和不正確的結果。當剖析不同字串，剖析之字串的結尾開始前解析下。此外，請注意在危險的可能性，呼叫這些函式之一從另一個函式呼叫的迴圈內時。使用這些函式之一，如果其他函式的結果，呼叫的交錯順序，否則會發生觸發資料毀損。

泛用文字常式對應

TCHAR.H 常式	未定義 _UNICODE & _MBCS	已定義 _MBCS	已定義 _UNICODE
_tcstok	strtok	_mbstok	wcstok
_tcstok	_strtok_l	_mbstok_l	_wcstok_l

需求

程序	必要的標頭檔
strtok	<string.h>
wcstok	<string.h> 或 <wchar.h>
_mbstok, _mbstok_l	<mbstring.h>

如需其他相容性資訊，請參閱入門介紹中的相容性 (Compatibility) 。

範例

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