std::wcscpy(3)

💖 std::wcscpy(3) 💖

okay so this is the std::wcscpy(3) page, bestie, and it comes from the C++ Standard Libary (their spelling, not mine 💀). It's giving "copy a wide string" energy, and we're gonna get into it.

✨ NAME ✨

std::wcscpy — literally std::wcscpy. That's the name. No notes. 💅

🌸 Synopsis 🌸

Defined in header <cwchar>:

wchar_t* wcscpy( wchar_t* dest, const wchar_t* src );

okay so what it does: it copies the wide string pointed to by src — including the terminating null wide character — into the wide character array pointed to by dest. slay.

⚠️ If the strings overlap, the behavior is undefined. bestie. do not overlap them. that is not the move. 😭

🎀 Parameters 🎀

• dest — pointer to the wide character array to copy to.
• src — pointer to the null-terminated wide string to copy from.

💅 Return value 💅

It returns dest. that's it, that's the whole return value. iconic. ✨

🦋 Example 🦋

The page literally says // Run this code, so go off:

        #include <clocale>
        #include <cwchar>
        #include <iostream>
        #include <memory>

        int main()
        {
            const wchar_t* src = L"犬 means dog";
        //  src[0] = L'狗'; // can't modify string literal
            auto dst = std::make_unique<wchar_t[]>(std::wcslen(src) + 1); // +1
       for the null
            std::wcscpy(dst.get(), src);
            dst[0] = L'狗';
            std::setlocale(LC_ALL, "en_US.utf8");
            std::wcout.imbue(std::locale(""));
            std::wcout << src << '\n' << dst.get() << '\n';
        }

🌈 Output 🌈

犬 means dog
狗 means dog

🦋 See also 🦋

• wcsncpy — copies a certain amount of wide characters from one string to another. (function)
• wmemcpy — copies a certain amount of wide characters between two non-overlapping arrays. (function)
• strcpy — copies one string to another. (function)
• C documentation for wcscpy.

💖 source: http://cppreference.com • version/date: 2024.06.10 • page: std::wcscpy(3) 💖