std::wcspbrk

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (C++20)

語言支援庫

概念庫 (C++20)

診斷庫

記憶體管理庫

超程式設計庫 (C++11)

通用工具庫

容器庫

迭代器庫

範圍庫 (C++20)

演算法庫

字串庫

文字處理庫

數值庫

日期和時間庫

輸入/輸出庫

檔案系統庫 (C++17)

併發支援庫 (C++11)

執行控制庫 (C++26)

技術規範

符號索引

外部庫

 

文字處理庫

本地化庫

正則表示式庫 (C++11)

格式化庫 (C++20)

空終止序列工具

位元組字串

多位元組字串

寬字串

原生數值轉換

to_chars (C++17) to_chars_result (C++17) from_chars (C++17) from_chars_result (C++17) chars_format (C++17)

文字編碼標識

text_encoding (C++26)

 

空終止寬字串

函式
字元分類
iswalnum iswalpha iswlower iswupper iswdigit iswxdigit wctype	iswblank (C++11) iswctype iswcntrl iswgraph iswspace iswprint iswpunct
字元操作
towlower towupper	towctrans wctrans
轉換為數字格式
wcstolwcstoll (C++11)   wcstofwcstodwcstold (C++11)(C++11)	wcstoulwcstoull (C++11) wcstoimaxwcstouimax (C++11)(C++11)
字串操作
wcslen wcscmp wcscoll wcsncmp wcschr wcsrchr	wcspbrk wcsspn wcscspn wcsstr wcstok
字串檢查
wcscpy wcsncpy wcsxfrm	wcscat wcsncat
陣列操作
wmemcpy wmemmove wmemcmp	wmemchr wmemset
型別 wctrans_t wctype_t wint_t	宏 WCHAR_MIN WCHAR_MAX WEOF

 

在標頭檔案 <cwchar> 中定義
const wchar_t* wcspbrk( const wchar_t* dest, const wchar_t* src );
wchar_t* wcspbrk(       wchar_t* dest, const wchar_t* src );

在寬字串 dest 中查詢第一個出現在寬字串 src 中的字元。

引數

dest	-	指向待分析的空終止寬字串的指標
src	-	指向包含要搜尋的字元的空終止寬字串的指標

返回值

指向 dest 中第一個同時存在於 src 中的字元的指標，如果不存在這樣的字元，則返回空指標。

注意

這個名稱代表“寬字元字串指標中斷（wide character string pointer break）”，因為它返回一個指向第一個分隔符（“中斷”）字元的指標。

示例

執行此程式碼

#include <cwchar>
#include <iomanip>
#include <iostream>
 
int main()
{
    const wchar_t* str = L"Hello world, friend of mine!";
    const wchar_t* sep = L" ,!";
 
    unsigned int cnt = 0;
    do
    {
        str = std::wcspbrk(str, sep); // find separator
        std::wcout << std::quoted(str) << L'\n';
        if (str)
            str += std::wcsspn(str, sep); // skip separator
        ++cnt; // increment word count
    } while (str && *str);
 
    std::wcout << L"There are " << cnt << L" words\n";
}

輸出

" world, friend of mine!"
", friend of mine!"
" of mine!"
" mine!"
"!"
There are 5 words

參閱

wcscspn	返回由另一個位元組字串中找到的字元組成的最大初始段的長度 僅當另一個寬字串中未找到寬字元時 (函式)
wcschr	在寬字串中查詢寬字元的首次出現 (函式)
strpbrk	查詢分隔符集中任何字元的第一個位置 (函式)
C 文件 關於 wcspbrk