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

💖 NAME 💖

std::experimental::simd::copy_to — okay bestie, the name is literally std::experimental::simd::copy_to, and it’s also std::experimental::simd::copy_to again. We love a self-referential icon. This is the std::experi...md::copy_to(3) page from the C++ Standard Libary manual. ✨

✨ Synopsis ✨

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

The store function copies all elements of a simd such that the i-th element is converted to U and subsequently written to mem[i] for all i in the range of [0, size()). That’s the whole vibe. 💅

🌸 Parameters 🌸

• mem — a pointer into an array where [mem, mem + size()) is a valid range. Keep that range valid, periodt. 🫶
• flags — if of type vector_aligned_tag, the load constructor may assume mem to point to storage aligned by memory_alignment_v<simd, U>.

yes bestie, it really says “load constructor” on a store function — we don’t ask questions, we just keep the text exactly as it is 💅

🦋 Type requirements 🦋

• U must be a vectorizable type.
• is_simd_flag_type_v<Flags> must be true.

No cap, those have to hold. ✅

🎀 Example 🎀

// Run this code

#include <experimental/simd>
#include <iostream>
namespace stdx = std::experimental;

int main()
{
    alignas(stdx::memory_alignment_v<stdx::native_simd<int>>)
        std::array<int, stdx::native_simd<int>::size()> mem = {};

    stdx::native_simd<int> a = 7;
    a.copy_to(&mem[0], stdx::vector_aligned);

    for (int e : mem)
        std::cout << e << ' ';
    std::cout << '\n';
}

🍓 Possible output: 🍓

7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7

👑 See also 👑

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

okay bestie, that’s the whole page 💖 sourced from http://cppreference.com, version/date 2024.06.10. go off and copy those simd elements with main character energy ✨💅