std::wmemchr(3)

🦋 std::wmemchr(3) 🦋

okay so bestie, welcome to the C++ Standard Libary manual page for std::wmemchr — yes, the manual name is literally “C++ Standard Libary” and we are not fixing it, we respect the typo 💅. This one is a wide-character search function, and it's lowkey iconic.

---

✨ NAME ✨

std::wmemchr - std::wmemchr

it's giving self-titled debut album — the NAME field is just the function name twice, and honestly? slay.

---

🎀 Synopsis 🎀

Defined in header <cwchar> 💖

const wchar_t* wmemchr( const wchar_t* ptr, wchar_t ch, std::size_t count ); (1)
wchar_t* wmemchr(       wchar_t* ptr, wchar_t ch, std::size_t count );       (2)

okay so what does it do? It locates the first occurrence of wide character ch in the initial count wide characters of the wide character array pointed to by ptr. fr fr, it's snooping through the first count wide chars and looking for your fave.

🚨 caveat bestie: if count is zero, the function returns a null pointer. no searching, no vibes, just nullptr. periodt.

---

💅 Parameters 💅

• ptr — pointer to the wide character array to be examined. the alley we're snooping through 🔍
• ch — wide character to search for. the one we want 💖
• count — number of wide characters to examine. how many slots we're checking, no more no less ✨

---

🫶 Return value 🫶

Pointer to the location of the wide character, or a null pointer if no such character is found. so if it finds ch, you get the address; if not, you get nullptr and a little moment of silence 😭

---

🌈 Example 🌈

       // Run this code

        #include <clocale>
        #include <cwchar>
        #include <iostream>
        #include <locale>

        int main()
        {
            const wchar_t str[] =
       L"诺不轻信，故人不负我\0诺不轻许，故我不负人。";
            wchar_t target = L'许';
            const std::size_t sz = sizeof str / sizeof *str;
            if (const wchar_t* result = std::wmemchr(str, target, sz))
            {
                std::setlocale(LC_ALL, "en_US.utf8");
                std::wcout.imbue(std::locale("en_US.utf8"));
                std::wcout << "Found '" << target << "' at position " << result
       - str << '\n';
            }
        }

literally the code is doing the whole detective arc: it searches the wide string for L'许', and if it finds it, it sets the locale and prints the position. ate and left no crumbs 🍓

---

⭐ Possible output ⭐

Found '许' at position 14

---

👑 See also 👑

• memchr — searches an array for the first occurrence of a character (function)
• strchr — finds the first occurrence of a character (function)
• wcschr — finds the first occurrence of a wide character in a wide string (function)
• find
• find_if — finds the first element satisfying specific criteria
• find_if_not — (function template) — (C++11)
• C documentation for wmemchr

---

and that's the page, bestie 🫶 sourced from the page URL http://cppreference.com, dated 2024.06.10, and filed under the std::wmemchr(3) page. go forth and search your wide chars with main character energy 👑✨