strtok_s、 _strtok_s_l、 wcstok_s、 _wcstok_s_l、 _mbstok_s、 _mbstok_s_l

發行項
03/27/2013

尋找字串中的下一個語彙基元，並使用目前的地區設定或地區設定。這些是 strtok、 _strtok_l、 wcstok、 _wcstok_l、 _mbstok、 _mbstok_l 的安全性增強版本，如安全性功能，則在 CRT 中中所述。

重要事項
_mbstok_s 和 _mbstok_s_l 不能用於 Windows 執行階段執行的應用程式。如需詳細資訊，請參閱 CRT 函式不支援使用 /ZW。

char *strtok_s(
char *strToken,
const char *strDelimit,
   char **context
);
char *_strtok_s_l(
char *strToken,
const char *strDelimit,
   char **context,
_locale_tlocale
);
wchar_t *wcstok_s(
wchar_t *strToken,
const wchar_t *strDelimit, 
   wchar_t**context
);
wchar_t *_wcstok_s_l(
wchar_t *strToken,
const wchar_t *strDelimit, 
   wchar_t**context,
_locale_tlocale
);
unsigned char *_mbstok_s(
unsigned char*strToken,
const unsigned char *strDelimit, 
   char **context
);
unsigned char *_mbstok_s(
unsigned char*strToken,
const unsigned char *strDelimit, 
   char **context,
_locale_tlocale
);

參數

strToken
包含語彙基元或語彙基元的字串。
strDelimit
一組分隔符號字元。
context
用來儲存在呼叫之間的位置資訊至 strtok_s。
locale
使用的地區設定。

傳回值

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

錯誤情況

strToken	strDelimit	context	傳回值	errno
NULL	any	為 null 指標的指標。	NULL	EINVAL
any	NULL	any	NULL	EINVAL
any	any	NULL	NULL	EINVAL

如果 strToken 是 NULL ，但是內容是指向有效的內容指標，沒有任何錯誤。

備註

strtok_s 函式會出現在 strToken的下一個語彙基元。集合中 strDelimit 的字元指定在目前呼叫中的 strToken 中找到的權杖的符號。wcstok_s 和 _mbstok_s都是 strtok_s寬字元和多位元組字元版本。引數和傳回值 wcstok_s 和 _wcstok_s_l 是寬字元字串;與 _mbstok_s 和 _mbstok_s_l 是多位元組字元字串。這三個函式其餘部分的運作相同。

這個函式會驗證其參數。當錯誤條件發生時，發生錯誤狀況表格中，無效的參數叫用處理常式，如參數驗證中所述。如果執行允許繼續， EINVAL 和 NULL傳回的這些函式設定的 errno 。

泛用文字常式對應

TCHAR.H 常式	未定義 _UNICODE & _MBCS	已定義 _MBCS	已定義 _UNICODE
_tcstok_s	strtok_s	_mbstok_s	wcstok_s
_tcstok_s_l	_strtok_s_l	_mbstok_s_l	_wcstok_s_l

在對 strtok_s 的呼叫函式略過前置正負號並傳回指標至 strToken的第一個語彙基元，是以 null 字元的語彙基元。多個語彙基元可以開啟 strToken 餘數由對 strtok_s的一系列的呼叫。對 strtok_s 的每個呼叫都會透過插入 null 字元修改 strToken 在該呼叫傳回的語彙基元之後。context 指標記錄哪個資料讀取資料，並在下一個語彙基元要讀取的地方。要讀取 strToken的下一個語彙基元，請改為使用 NULL 值的 strtok_sstrToken 引數的，並將相同的 context 參數。NULLstrToken 引數造成 strtok_s 搜尋已修改 strToken的下一個語彙基元。strDelimit 引數可以接受來自呼叫的任何值到下，以便組符號可以變更。

因為 context 參數替換用於 strtok 和 _strtok_l的靜態緩衝區，同時解決兩個字串在相同執行緒是可能的。

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

需求

程序	必要的標頭檔
strtok_s	<string.h>
_strtok_s_l	<string.h>
wcstok_s, _wcstok_s_l	<string.h> 或 <wchar.h>
_mbstok_s, _mbstok_s_l	<mbstring.h>

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

範例

// crt_strtok_s.c
// In this program, a loop uses strtok_s
// to print all the tokens (separated by commas
// or blanks) in two strings at the same time.
//

#include <string.h>
#include <stdio.h>

char string1[] =
    "A string\tof ,,tokens\nand some  more tokens";
char string2[] =
    "Another string\n\tparsed at the same time.";
char seps[]   = " ,\t\n";
char *token1 = NULL;
char *token2 = NULL;
char *next_token1 = NULL;
char *next_token2 = NULL;

int main( void )
{
    printf( "Tokens:\n" );

    // Establish string and get the first token:
    token1 = strtok_s( string1, seps, &next_token1);
    token2 = strtok_s ( string2, seps, &next_token2);

    // While there are tokens in "string1" or "string2"
    while ((token1 != NULL) || (token2 != NULL))
    {
        // Get next token:
        if (token1 != NULL)
        {
            printf( " %s\n", token1 );
            token1 = strtok_s( NULL, seps, &next_token1);
        }
        if (token2 != NULL)
        {
            printf("        %s\n", token2 );
            token2 = strtok_s (NULL, seps, &next_token2);
        }
    }
}