wcschr

Определено в заголовке `<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) Находит первое вхождение широкого символа ch в широкой строке, на которую указывает str.

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 Функция wcschr (стр. 435)

Стандарт C99 (ISO/IEC 9899:1999):

7.24.4.5.1 Функция wcschr (стр. 381)

См. также

wcsrchr (C95)	находит последнее вхождение широкого символа в широкой строке (функция)
wcspbrk (C95)	находит первое положение любого широкого символа в одной широкой строке, в другой широкой строке (функция)
Документация C++ для `wcschr`

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/c/string/wide/wcschr