std::experi...lit,split_by(3)

🦋 std::experimental::split, split_by — C++ Standard Libary 🦋

Manual-name moment: std::experi...lit,split_by(3). Bestie, we are in the C++ Standard Libary, and this page is all about splitting simd / simd_mask objects. It’s giving parallelism TS v2 realness. 💅

✨ NAME ✨

std::experimental::split,split_by — std::experimental::split,split_by

🌸 Synopsis 🌸

Defined in header <experimental/simd>

template< std::size_t... Sizes, class T, class Abi >
std::tuple<simd<T, simd_abi::deduce_t<T, Sizes>>...>         (1)
(parallelism TS v2)
split( const simd<T, Abi>& v ) noexcept;

template< std::size_t... Sizes, class T, class Abi >
std::tuple<simd_mask<T, simd_abi::deduce_t<T, Sizes>>...>    (2)
(parallelism TS v2)
split( const simd_mask<T, Abi>& v ) noexcept;

template< class V, class Abi >
std::array<V, simd_size_v<typename V::value_type, Abi> /
V::size()>                                                   (3)
(parallelism TS v2)
split( const simd<typename V::value_type, Abi>& v )
noexcept;

template< class V, class Abi >
std::array<V, simd_size_v<typename V::value_type, Abi> /
V::size()>                                                   (4)
(parallelism TS v2)
split( const simd_mask<typename V::value_type, Abi>& v )
noexcept;

template< size_t N, class T, class A >
array<resize_simd<simd_size_v<T, A> / N, simd<T, A>>, N>     (5)
(parallelism TS v2)
split_by( const simd<T, A>& v ) noexcept;

template< size_t N, class T, class A >
array<resize_simd<simd_size_v<T, A> / N, simd_mask<T, A>>,   (6)
(parallelism TS v2)
N>
split_by( const simd_mask<T, A>& v ) noexcept;

Okay so the whole vibe: these split the input simd or simd_mask object into multiple simd or simd_mask objects. Periodt. 🌈

• 1, 2 — these split the input object into potentially different types of objects, e.g. types with different sizes. These functions do not participate in overloading resolution unless Sizes... sum up to v.size(). No cap.
• 3, 4 — these split the input object into an array of objects. These functions do not participate in overloading resolution unless:
  • The array element must be of type simd or simd_mask, for the type of v as simd or simd_mask, respectively.
  • simd_size_v<typename V::value_type, Abi> is an integral multiple of V::size().
• 5, 6 — these split the input object into an array of objects. These functions shall not participate in overload resolution unless simd_size_v<T, A> is an integral multiple of N.

🫶 Parameters 🫶

• v — the input simd or simd_mask object.

👑 Return value 👑

• 1, 2 — a tuple that contains the splitted simd or simd_mask objects.
• 3–6 — an array that contains the splitted simd or simd_mask objects.

🎀 Example 🎀

This section is incomplete Reason: no example

💀 Category 💀

• Todo no example

Cute sign-off at the very end, bestie: source/version/date = http://cppreference.com · 2024.06.10 · page std::experi...lit,split_by(3). 💖✨