共用方式為


strtok_s、 _strtok_s_l、 wcstok_s、 _wcstok_s_l、 _mbstok_s、 _mbstok_s_l

尋找字串中的下一個語彙基元,並使用目前的地區設定或地區設定。 這些是 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);
        }
    }
}
     

.NET Framework 對等用法

不適用。若要呼叫標準 C 函式,請使用 PInvoke。如需更多的資訊,請參閱 Platform Invoke Examples

請參閱

參考

字串操作 (CRT)

地區設定

多位元組字元序列的轉譯工作

strcspn、 wcscspn、 _mbscspn、 _mbscspn_l

strspn、 wcsspn、 _mbsspn、 _mbsspn_l