wcschr

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

参数

str - 指向待分析的空终止宽字符的指针
ch - 要搜索的宽字符

返回值

指向 str 中找到的字符的指针,或若找不到这种字符则为空指针。

示例

#include <wchar.h>
#include <stdio.h>
#include <locale.h>
 
int main(void)
{
    wchar_t arr[] = L"白猫 黒猫 кошки";
    wchar_t *cat = wcschr(arr, L'猫');
    wchar_t *dog = wcschr(arr, L'犬');
 
    setlocale(LC_ALL, "en_US.utf8");
    if(cat)
        printf("The character 猫 found at position %td\n", cat-arr);
    else
        puts("The character 猫 not found");
 
    if(dog)
        printf("The character 犬 found at position %td\n", dog-arr);
    else
        puts("The character 犬 not found");
}

输出:

The character 猫 found at position 1
The character 犬 not found


引用

  • C11 标准(ISO/IEC 9899:2011):
  • 7.29.4.5.1 The wcschr function (第 435 页)
  • C99 标准(ISO/IEC 9899:1999):
  • 7.24.4.5.1 The wcschr function (第 381 页)

参阅

查找宽字符在宽字符串中的最后一次出现
(函数)
查找一个宽字符串中的任何字符在另一个宽字符串中的首个位置
(函数)