std::simd::basic_vec, std::simd::simd

Defined in header `<simd>`
template< class T, class Abi = /native-abi/<T> > class basic_vec;	(1)	(since C++26)
template< class T, /simd-size-type/ N = /simd-size-v/<T, /native-abi/<T>> > using simd = basic_vec<T, /deduce-abi-t/<T, N>>;	(2)	(since C++26)

1) std::simd::basic_vec specialization is a data-parallel type. The default ABI tag is determined by the implementation at compile-time.

2) std::simd::vec is an alias template that allows users to specify the width to a certain size. The default width is determined by the implementation at compile-time.

Every specialization of basic_vec is a complete type. The specialization is

enabled, if T is a vectorizable type, and there exists value M in the range [1, 64] such that Abi is deduce-abi-t<T,M>,
otherwise disabled, if T is not a vectorizable type,
otherwise, it is implementation-defined if such specialization is enabled.

If basic_vec<T,Abi> is disabled, the specialization has all deleted default constructor, destructor, copy constructor, and copy assignment. In addition, only the member types below are present.

If basic_vec<T,Abi> is enabled, basic_vec<T,Abi> is TriviallyCopyable.

Template parameters

T	-	element type; a vectorizable type
Abi	-	tag type used to determine the width and storage
N	-	the width of the data-parallel type; the number of elements

Member types

Type	Definition
`value_type`	`T`
`mask_type`	simd::basic_mask<sizeof(T),Abi>
`abi_type`	`Abi`

Member constant

Name	Description
`simd-size-type` `simd-size-v` size [static]	the width of `basic_vec` (public static member constant)

Member functions

Template:cpp/numeric/simd/basic vec/dsc constructor Template:cpp/numeric/simd/basic vec/dsc operator at Template:cpp/numeric/simd/basic vec/dsc operator mem arith Template:cpp/numeric/simd/basic vec/dsc operator mem arith2

Non-member functions

Template:cpp/numeric/simd/basic vec/dsc operator arith Template:cpp/numeric/simd/basic vec/dsc operator compound Template:cpp/numeric/simd/basic vec/dsc operator cmp

Template:cpp/numeric/simd/basic vec/dsc simd select

Deduction guide

template< class R, class... Ts >
basic_vec( R&& r, Ts... ) -> /* see below */;

(since C++26)

The deduction guide is present only if:

R models contiguous_range and sized_range, and
ranges::size(r) is a constant expression.

The deduced type is equivalent to simd::vec<ranges::range_value_t<R>,ranges::size(r)>.

Notes

Implementations are recommended to support explicit conversions between enabled specializations of basic_vec and appropriate implementation-defined types. These appropriate types are non-standard vector types which are available in the implementation.

simd::basic_mask (C++26)	data-parallel type with the element type bool (class template)
simd::mask (C++26)	convenience alias template for `basic_mask` that can specify its width (alias template)
valarray	numeric arrays, array masks and array slices (class template)