std::wcschr (3) - Linux Manuals

std::wcschr: std::wcschr

NAME

std::wcschr - std::wcschr

Synopsis


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