std::wcschr

 

C++

Compiler support

Freestanding and hosted

Language

Standard library

Standard library headers

Named requirements

Feature test macros (C++20)

Language support library

Concepts library (C++20)

Diagnostics library

Memory management library

Metaprogramming library (C++11)

General utilities library

Containers library

Iterators library

Ranges library (C++20)

Algorithms library

Strings library

Text processing library

Numerics library

Date and time library

Input/output library

Filesystem library (C++17)

Concurrency support library (C++11)

Execution control library (C++26)

Technical specifications

Symbols index

External libraries

 

Text processing library

Localization library

Regular expressions library (C++11)

Formatting library (C++20)

Null-terminated sequence utilities

Byte strings

Multibyte strings

Wide strings

Primitive numeric conversions

to_chars (C++17) to_chars_result (C++17) from_chars (C++17) from_chars_result (C++17) chars_format (C++17)

Text encoding identifications

text_encoding (C++26)

 

Null-terminated wide strings

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

 

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 <cwchar>
#include <iostream>
#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	finds the first occurrence of the given substring (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)
C documentation for wcschr