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 所指的空终止宽字符串中的首次出现。不比较空终止字符。

若 src 或 dest 不是指向空终止字节字符串的指针，则行为未定义。

参数

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

返回值

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

示例

运行此代码

#include <iostream>
#include <cwchar>
#include <clocale>
 
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"Substring to find: \"" << target << L"\"\n"
               << L"String to search: " << origin << L"\n\n";
 
    for (; (result = std::wcsstr(result, target)) != NULL; ++result)
        std::wcout << L"found: " << result << '\n';
}

可能的输出：

Substring to find: "ベータ"
String to search: アルファ, ベータ, ガンマ, アルファ, ベータ, ガンマ.
 
found: ベータ, ガンマ, アルファ, ベータ, ガンマ.
found: ベータ, ガンマ.

参阅

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