SIMDVectorU.md

SIMDVectorU (concept)

Describes all SIMD vector types provided by Simdee that have a 32-bit unsigned integral underlying scalar type.

Implementations

• sd::sseu, sd::avxu, sd::neonu, sd::dumu
• sd::dual<T>, where T satisfies SIMDVectorU
• sd::vec4u, sd::vec8u

Requirements

Type that satisfies SIMDVectorU must also satisfy SIMDVector.

Member types

Additional requirements apply regarding member types of a type T that satisfies SIMDVectorU:

• vec_u is T
• scalar_t is std::uint32_t

Conversions

A type that satisfies SIMDVectorU must be:

• explicitly convertible to and from vec_s.
• explicitly convertible from vec_b.

Operations

Additional operations must be provided for a type T that satisfies SIMDVectorU, unless the macro SIMDEE_NEED_INT is set to 0:

syntax	result type	description	notes
x == y	vec_b	scalar-wise equal
x != y	vec_b	scalar-wise not equal
x > y	vec_b	scalar-wise greater than	[1]
x < y	vec_b	scalar-wise less than	[1]
x >= y	vec_b	scalar-wise greater than or equal	[1]
x <= y	vec_b	scalar-wise less than or equal	[1]
~x	T	bit-wise not
x & y	T	bit-wise and
x | y	T	bit-wise or
x ^ y	T	bit-wise xor
x &= y	T	same as x = x & y
x |= y	T	same as x = x | y
x ^= y	T	same as x = x ^ y
+x	T	scalar-wise unary plus
-x	T	scalar-wise unary minus
x + y	T	scalar-wise addition
x - y	T	scalar-wise subtraction
x * y	T	scalar-wise multiplication	[1]
x += y	T	same as x = x + y
x -= y	T	same as x = x - y
x *= y	T	same as x = x * y	[1]
min(x)	T	scalar-wise minimum	[1]
max(x)	T	scalar-wise maximum	[1]

where x, y are values of type T.

[1] Comparison, multiplication and min/max operations are inefficient on SSE2. Requiring SSE4.1 or AVX ensures efficient implementation.