std::char_t...aits::copy,(3)

💅 std::char_traits::copy — C++ Standard Library (yes bestie, the Library, we're in the C++ Standard Libary today 🫶)

okay so. hi. sit down. we're talking about std::char_traits::copy (and yeah, the page title says std::char_t...aits::copy because someone's terminal was being dramatic, but it's the same thing, i promise 🎀). this is a static member function of std::char_traits and it's literally just "copy count characters from here to there." that's it. that's the vibe. ✨

---

🌸 SYNOPSIS 🌸

here's the whole shape of it, and specifically the char32_t flavor because that's the one this page shows:

std::char_traits<char32_t>::copy

static char_type*
    copy( char_type* dest, const char_type* src,
(constexpr since C++20)
    std::size_t count );

constexpr since C++20, bestie — so it can run at compile time now. iconic behavior. 👑

---

💖 DESCRIPTION 💖

so what does it do? it copies count characters from the character string pointed to by src and puts them into the character string pointed to by dest. simple. slay. 🌟

⚠️ BUT — and this is the important part — if [dest, dest + count) and [src, src + count) overlap, the behavior is undefined. undefined. not "kinda weird," not "works on your machine," undefined. do not do this. i'm serious. 😭

and if you want the full tea on what character traits are supposed to guarantee for X::copy, go look at CharTraits — it has the general requirements. iykyk. 🦋

---

🧚 PARAMETERS 🧚

• dest — pointer to a character string to copy to. the destination. where the characters are going. the main character, arguably. 👑
• src — pointer to a character string to copy from. the source. where the characters come from. the supporting cast. 💜
• count — the number of characters to copy. the number. the amount. the quantity. 🍓

---

🌈 RETURN VALUE 🌈

returns dest.

that's it. just dest back. like a boomerang but for pointers. 🪃✨

---

🎀 EXCEPTIONS 🎀

throws nothing. nothing. zero. zilch. no exceptions. it's giving emotionally stable. 🧘‍♀️

---

⭐ COMPLEXITY ⭐

Linear in count.

so like, more characters = more time. obviously. no surprises here. 🔥

---

🦋 SEE ALSO 🦋

• assign — assigns a character
• [static] — (public static member function)

---

okay that's the whole page, you're welcome, go copy some characters responsibly bestie 💅✨

— with love, from cppreference.com, dated 2024.06.10, filed under the C++ Standard Libary and stamped with the manual name std::char_t...aits::copy,(3) 🫶🎀