std::experimental::where(3)

okay bestie, welcome to std::experimental::where(3) — a page from the C++ Standard Libary (yep, that's the manual name exactly as printed, no cap 💅). This one is all about building those where_expression / const_where_expression cuties, so let's get into it. 🫶

✨ NAME ✨

std::experimental::where — literally std::experimental::where. That's the whole name section, and it ate. 💖

🌸 Synopsis 🌸

Defined in header <experimental/simd>

          template< class T, class Abi >

          where_expression<simd_mask<T, Abi>, simd<T, Abi>>            (1)
       (parallelism TS v2)
              where( const typename simd<T, Abi>::mask_type& mask,

                     simd<T, Abi>& value ) noexcept;
          template< class T, class Abi >

          const_where_expression<simd_mask<T, Abi>, const simd<T,
          Abi>>                                                        (2)
       (parallelism TS v2)
              where( const typename simd<T, Abi>::mask_type& mask,

                     const simd<T, Abi>& value ) noexcept;
          template< class T, class Abi >

          where_expression<simd_mask<T, Abi>, simd_mask<T, Abi>>       (3)
       (parallelism TS v2)
              where( const type_identity_t<simd_mask<T, Abi>>& mask,

                     simd_mask<T, Abi>& value ) noexcept;
          template< class T, class Abi >

          const_where_expression<simd_mask<T, Abi>, const simd_mask<T,
          Abi>>                                                        (4)
       (parallelism TS v2)
              where( const type_identity_t<simd_mask<T, Abi>>& mask,

                     const simd_mask<T, Abi>& value ) noexcept;
          template< class T >

          where_expression<bool, T>                                    (5)
       (parallelism TS v2)

              where( /*see below*/ mask, T& value ) noexcept;
          template< class T >

          const_where_expression<bool, const T>                        (6)
       (parallelism TS v2)

              where( /*see below*/ mask, const T& value ) noexcept;

Constructs a new const_where_expression or where_expression.

1-6) Constructs a where_expression from given mask and value parameters. Periodt. ✨

🎀 Parameters 🎀

1-4)

• mask — the simd_mask object
• value — reference to the simd object that mask applies on

5,6)

• mask — the mask of type bool
• value — reference to the scalar that mask applies on

💫 Return value 💫

The constructed const_where_expression or where_expression. slay. ✨

🧠 Notes 🧠

5,6) Uses implementation defined type of mask, so that implicit conversions from other types to bool is disabled. That's the implementation-defined caveat, bestie — no cap. 💅

🦋 Example 🦋

This section is incomplete

Reason: no example

💀 Category 💀

Category:

• Todo no example

okay that's the whole page, bestie. Signing off with the footer tea: source/version is http://cppreference.com, dated 2024.06.10. Byeee 💖✨🎀