Namespaces
Variants

wcsstr

From cppreference.net
< c ‎ | string ‎ | wide
C
Strings library
Null-terminated wide strings
定义于头文件 <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 wcsstr 函数 (第 437 页)
  • C99 标准 (ISO/IEC 9899:1999):
  • 7.24.4.5.6 wcsstr 函数 (第 383 页)

参阅

(C95)
在宽字符串中查找宽字符的首次出现
(函数)
(C95)
在宽字符串中查找宽字符的最后一次出现
(函数)
C++ 文档 for wcsstr