std::wcschr

 

C++

Language

Standard Library Headers

Freestanding and hosted implementations

Named requirements

Language support library

Concepts library (C++20)

Diagnostics library

Utilities library

Strings library

Containers library

Iterators library

Ranges library (C++20)

Algorithms library

Numerics library

Input/output library

Localizations library

Regular expressions library (C++11)

Atomic operations library (C++11)

Thread support library (C++11)

Filesystem library (C++17)

Technical Specifications

 

Strings library

Null-terminated strings

Byte strings

Multibyte strings

Wide strings

Classes

basic_string

basic_string_view (C++17)

char_traits

 

Null-terminated wide strings

Functions
Character manipulation
iswalnum iswalpha iswlower iswupper iswdigit iswxdigit iswblank (C++11) wctype iswctype	iswcntrl iswgraph iswspace iswprint iswpunct towlower towupper wctrans towctrans
Conversions to numeric formats
wcstolwcstoll (C++11) wcstoulwcstoull (C++11)	wcstofwcstodwcstold (C++11)(C++11) wcstoimaxwcstouimax (C++11)(C++11)
String manipulation
wcslen wcscpy wcsncpy wcscat wcsncat wcscmp wcscoll wcsncmp	wcsxfrm wcschr wcsrchr wcspbrk wcsspn wcscspn wcsstr wcstok
Array manipulation
wmemcpy
wmemmove
wmemcmp
wmemchr
wmemset

 

Defined in header <cwchar>
const wchar_t* wcschr( const wchar_t* str, wchar_t ch );
wchar_t* wcschr(       wchar_t* str, wchar_t ch );

Finds the first occurrence of the wide character ch in the wide string pointed to by str.

Parameters

str	-	pointer to the null-terminated wide string to be analyzed
ch	-	wide character to search for

Return value

Pointer to the found character in str, or NULL if no such character is found.

Example

Run this code

#include <iostream>
#include <cwchar>
#include <locale>
 
int main()
{
    wchar_t arr[] = L"招き猫 кошка";
    const wchar_t* cat = std::wcschr(arr, L'猫');
    const wchar_t* dog = std::wcschr(arr, L'犬');
 
    std::cout.imbue(std::locale("en_US.utf8"));
 
    if(cat)
        std::cout << "The character 猫 found at position " << cat - arr << '\n';
    else
        std::cout << "The character 猫 not found\n";
 
    if(dog)
        std::cout << "The character 犬 found at position " << dog - arr << '\n';
    else
        std::cout << "The character 犬 not found\n";
}

Output:

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

See also

find	find characters in the string (public member function of std::basic_string<CharT,Traits,Allocator>)
strchr	finds the first occurrence of a character (function)
wcsrchr	finds the last occurrence of a wide character in a wide string (function)
wcspbrk	finds the first location of any wide character in one wide string, in another wide string (function)