std::wcsstr

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

功能特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

并发支持库 (C++11)

技术规范

符号索引

外部库

 

字符串库

空终止字符串

字节字符串

多字节字符串

宽字符串

类

basic_string

basic_string_view (C++17)

char_traits

 

空终止宽字符串

函数
字符操作
iswalnum iswalpha iswlower iswupper iswdigit iswxdigit iswblank (C++11)   wctype iswctype	iswcntrl iswgraph iswspace iswprint iswpunct towlower towupper wctrans towctrans
转换到数值格式
wcstolwcstoll (C++11) wcstoulwcstoull (C++11)	wcstofwcstodwcstold (C++11)(C++11) wcstoimaxwcstouimax (C++11)(C++11)
字符串操作
wcslen wcscpy wcsncpy wcscat wcsncat wcscmp wcscoll wcsncmp	wcsxfrm wcschr wcsrchr wcspbrk wcsspn wcscspn wcsstr wcstok
数组操作
wmemcpy wmemmove wmemcmp	wmemchr wmemset

 

在标头 <cwchar> 定义
const wchar_t* wcsstr( const wchar_t* dest, const wchar_t* src );
wchar_t* wcsstr(       wchar_t* dest, const wchar_t* src );

寻找 dest 所指的空终止宽字符串在 src 所指的空终止宽字符串中的首次出现。不比较空终止字符。

参数

dest	-	指向要检验的空终止字节字符串的指针
src	-	指向要搜索的空终止宽字符串的指针

返回值

指向于 dest 中找到的子串首字符的指针，或若找不到该子串则为空指针。若 src 指向空字符串，则返回 dest。

示例

运行此代码

#include <clocale>
#include <cwchar>
#include <iostream>
 
int main()
{
    wchar_t const* origin = L"アルファ, ベータ, ガンマ, アルファ, ベータ, ガンマ.";
    wchar_t const* target = L"ベータ";
    wchar_t const* result = origin;
 
    std::setlocale(LC_ALL, "en_US.utf8");
    std::wcout << L"要寻找的子串: \"" << target << L"\"\n"
               << L"要搜索的字符串: \"" << origin << L"\"\n\n";
 
    for (; (result = std::wcsstr(result, target)) != nullptr; ++result)
        std::wcout << L"找到: \"" << result << L"\"\n";
}

可能的输出：

要寻找的子串: "ベータ"
要搜索的字符串: "アルファ, ベータ, ガンマ, アルファ, ベータ, ガンマ."
 
找到: "ベータ, ガンマ, アルファ, ベータ, ガンマ."
找到: "ベータ, ガンマ."

参阅

find	寻找给定子串的首次出现 (std::basic_string<CharT,Traits,Allocator> 的公开成员函数)
strstr	寻找字符子串的首次出现 (函数)
wcschr	寻找宽字符串中宽字符的首次出现 (函数)
wcsrchr	在宽字符串中寻找宽字符的最后一次出现 (函数)