wcsstr

来自cppreference.com
< c‎ | string‎ | wide
在标头 <wchar.h> 定义
wchar_t *wcsstr( const wchar_t *dest, const wchar_t *src );
(1) (C95 起)
/*QWchar_t*/ *wcsstr( /*QWchar_t*/ *dest, const wchar_t *src );
(2) (C23 起)
1) 寻找 dest 所指的空终止宽字符串在 src 所指的空终止宽字符串中的首次出现。不比较空终止字符。
2) 等价于 (1) 的泛型函数。令 T 为未限定的 宽字符对象类型。
  • dest 类型为 const T*,则返回类型为 const wchar_t*
  • 否则,若 dest 类型为 T*,返回类型为 wchar_t*
  • 否则,行为未定义。
如果这些泛型函数中的某个宏定义被抑制无法访问实际函数(比如当使用了 (wcsstr) 或使用了函数指针时),则实际函数声明 (1) 即变得可见。

参数

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

返回值

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

示例

#include <stdio.h>
#include <locale.h>
#include <wchar.h>
 
int main(void)
{
    setlocale(LC_ALL, "ru_RU.UTF-8");
 
    wchar_t str[5][64] = {
        L"Строка, где есть подстрока 'но'.",
        L"Строка, где такой подстроки нет.",
        L"Он здесь.",
        L"Здесь он.",
        L"Его нет."
    };
 
    for (size_t i = 0; i < 5; ++i) {
        if (wcsstr(str[i], L"но")) {
            wprintf(L"%ls\n", str[i]);
        }
    }
}

输出:

Строка, где есть подстрока 'но'.

引用

  • C11 标准(ISO/IEC 9899:2011):
  • 7.29.4.5.6 The wcsstr function (第 437 页)
  • C99 标准(ISO/IEC 9899:1999):
  • 7.24.4.5.6 The wcsstr function (第 383 页)

参阅

(C95)
查找宽字符在宽字符串中的首次出现
(函数)
查找宽字符在宽字符串中的最后一次出现
(函数)