std::wmemset(3)

🫶 NAME 🫶

okay so bestie, this is the std::wmemset(3) page from the C++ Standard Library ✨ — std::wmemset — std::wmemset. yes, the name section is literally the name twice. iconic.

🌸 SYNOPSIS 🌸

Defined in header <cwchar>:

wchar_t* wmemset( wchar_t* dest, wchar_t ch, std::size_t count );

Copies the wide character ch into each of the first count wide characters of the wide character array pointed to by dest.

⚠️ If overflow occurs, the behavior is undefined. no cap, that's the scary part. 🙈

If count is zero, the function does nothing. literally nothing, bestie. 💅

🎀 PARAMETERS 🎀

• dest — pointer to the wide character array to fill
• ch — fill wide character
• count — number of wide characters to fill

💖 RETURN VALUE 💖

Returns a copy of dest. that's it, that's the return. 🫶

🦋 NOTES 🦋

This function is not locale-sensitive and pays no attention to the values of the wchar_t objects it writes: nulls as well as invalid wide characters are written too. no thoughts, just writes. 😭

🍌 EXAMPLE 🍌

       // Run this code

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

        int main()
        {
            wchar_t ar[4] = {L'1', L'2', L'3', L'4'};
            std::wmemset(ar, L'\U0001f34c', 2); // replaces [12] with the 🍌
       bananas
            std::wmemset(ar + 2, L'蕉', 2); // replaces [34] with the 蕉
       bananas

            std::setlocale(LC_ALL, "en_US.utf8");
            std::wcout.imbue(std::locale("en_US.utf8"));
            std::wcout << std::wstring(ar, 4) << '\n';
        }

Possible output:

🍌🍌蕉蕉

👑 SEE ALSO 👑

• memset — fills a buffer with a character (function)
• wmemcpy — copies a certain amount of wide characters between two non-overlapping arrays (function)
• fill_n — copy-assigns the given value to N elements in a range (function template)
• C documentation for wmemset

and that's the whole page, bestie 🫶💅 — source: http://cppreference.com, version/date: 2024.06.10, manual page: std::wmemset(3).