std::experi...ask::copy_to(3)

🎀 NAME 🎀

okay bestie, this is std::experimental::simd_mask::copy_to — the simd_mask copy_to, from the C++ Standard Libary manual (yes, the header spells it like that, I'm just the messenger 💀). The page is the std::experi...ask::copy_to(3) one, and the name is literally std::experimental::simd_mask::copy_to. That's the whole NAME section, no notes. 💅

🌸 Synopsis 🌸

template<class Flags>                    (parallelism TS v2)
void copy_to( bool* mem, Flags flags );

So yeah, it's a template with a Flags parameter, and it's tagged parallelism TS v2. Slay. ✨

The store function copies all elements of a simd_mask such that the i-th element is written to mem[i] for all i in the range of [0, size()). That's the whole job, bestie — very "copy the mask, mind the range" energy. 🫶

🧚 Parameters 🧚

• mem — a pointer into an array where [mem, mem + size()) is a valid range.
• flags — if it's of type vector_aligned_tag, the load constructor may assume mem to point to storage aligned by memory_alignment_v<simd_mask>.

✅ Type requirements ✅

• is_simd_flag_type_v<Flags> must be true.

no cap, that requirement is non-negotiable — it literally has to be true. 💖

👀 See also 👀

• element_aligned_tag — flag indicating alignment of the load/store address to element alignment; element_aligned (parallelism TS v2) (class)
• vector_aligned_tag — flag indicating alignment of the load/store address to vector alignment; vector_aligned (parallelism TS v2) (class)
• overaligned_tag — flag indicating alignment of the load/store address to the specified alignment; overaligned (parallelism TS v2) (class template)
• memory_alignment — obtains an appropriate alignment for vector_aligned (parallelism TS v2) (class template)
• copy_from — loads simd_mask elements from contiguous memory (parallelism TS v2) (public member function)

🌸 that's a wrap, bestie — source is http://cppreference.com, dated 2024.06.10, and the footer page is std::experi...ask::copy_to(3). go be aligned 💖✨