std::wcschr

C++

Language

Headers

Freestanding and hosted implementations

Named requirements

Language support library

Concepts library (C++20)

Diagnostics library

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)

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)
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)