# std::wcsrchr

> C++ Atlas: `cppatlas.com/w/cpp/string/wide/wcsrchr` | Source: https://en.cppreference.com/w/cpp/string/wide/wcsrchr | Domain: Strings

Finds the last occurrence of the wide character ch in the wide string pointed to by str.

## Official Specification Summary (cppreference)

```cpp
// Defined in header <cwchar>
const wchar_t* wcsrchr( const wchar_t* str, wchar_t ch );
wchar_t* wcsrchr(       wchar_t* str, wchar_t ch );
```

Finds the last 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

```cpp
#include <cwchar>
#include <iostream>
#include <locale>

int main()
{
    const wchar_t arr[] = L"白猫 黒猫 кошки";
    const wchar_t* cat = std::wcsrchr(arr, L'猫');
    const wchar_t* dog = std::wcsrchr(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:

```text
The character 猫 found at position 4
The character 犬 not found
```

### See also

- [`wcschr`](https://en.cppreference.com/w/cpp/string/wide/wcschr): finds the first occurrence of a wide character in a wide string (function)
- [`strrchr`](https://en.cppreference.com/w/cpp/string/byte/strrchr): finds the last occurrence of a character (function)
- [`rfind`](https://en.cppreference.com/w/cpp/string/basic_string/rfind): find the last occurrence of a substring (public member function of `std::basic_string<CharT,Traits,Allocator>`)
- [C documentation for `wcsrchr`](https://en.cppreference.com/w/c/string/wide/wcsrchr)

---
Attribution: content from https://en.cppreference.com/w/cpp/string/wide/wcsrchr (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.