std::wcsrchr(3)

💖 NAME 💖

Okay so bestie, welcome to the page for std::wcsrchr — and yes, the name is literally std::wcsrchr too 💅. This is from the C++ Standard Libary manual, and it's giving “find the last wide-character match” main character energy. 🦋

✨ Synopsis ✨

Defined in header <cwchar> 🎀

const wchar_t* wcsrchr( const wchar_t* str, wchar_t ch );
    wchar_t* wcsrchr(       wchar_t* str, wchar_t ch );

So what does it do? Its whole job is to find the last occurrence of the wide character ch in the wide string pointed to by str. Like, it goes looking for the final match, not the first one — periodt. 🔥

🎀 Parameters 🎀

• str — pointer to the null-terminated wide string to be analyzed. That's your string bestie, null-terminated and ready for analysis 💖.
• ch — the wide character to search for. This is the one you're hunting for. 🔍

🌸 Return value 🌸

A pointer to the found character in str 💅, or a null pointer if no such character is found 😭. Match found = pointer, no match = null pointer. That's the vibe.

🐱 Example 🐱

Here's the code, complete with multilingual cat energy 🐾✨:

// Run this code

#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 ⭐

And the output is exactly this, no cap:

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

👑 See also 👑

• wcschr — finds the first occurrence of a wide character in a wide string (function) 🌈
• strrchr — finds the last occurrence of a character (function) 🔥
• rfind — find the last occurrence of a substring (public member function of std::basic_string<CharT,Traits,Allocator>) 🎀
• C documentation for wcsrchr 🦋

That's the whole page, bestie! 💖 Source: http://cppreference.com ✨ Version/date: 2024.06.10 🎀 Page: std::wcsrchr(3) 🫶