std::wcschr

 

C++

Language

Standard library headers

Concepts

Utilities library

Strings library

Containers library

Algorithms library

Iterators library

Numerics library

Input/output library

Localizations library

Regular expressions library (C++11)

Atomic operations library (C++11)

Thread support library (C++11)

 

Strings library

Null-terminated strings

Byte strings

Multibyte strings

Wide strings

Classes

basic_string

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
wcstol wcstoll wcstoul wcstoull	wcstof wcstod wcstold
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)
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)
C documentation for wcschr