std::wcschr

 

C++

Compiler support

Freestanding and hosted

Language

Standard library headers

Named requirements

Feature test macros (C++20)

Language support library

Concepts library (C++20)

Metaprogramming library (C++11)

Diagnostics library

General utilities library

Strings library

Containers library

Iterators library

Ranges library (C++20)

Algorithms library

Numerics library

Localizations library

Input/output library

Filesystem library (C++17)

Regular expressions library (C++11)

Concurrency support library (C++11)

Technical specifications

Symbols index

External libraries

 

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 a null pointer if no such character is found.

Example

Run this code

#include <iostream>
#include <cwchar>
#include <locale>
 
int main()
{
    const 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 1
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)