simdpp::sub_sat(integer)

 

libsimdpp

Types

Capabilities

Operations

Conversions

Bitwise operations

Floating-point operations

Integer operations

Memory access operations

Shuffle operations

Miscellaneous operations

 

Integer operations

Elementary operations
add add_sat	sub sub_sat	mul_lo mul_hi mull	neg
Comparisons
cmp_eq cmp_neq	cmp_lt cmp_gt	cmp_le cmp_ge
Reduction
reduce_add reduce_mul reduce_min reduce_max	reduce_and reduce_or reduce_popcnt
Miscellaneous
abs avg avg_trunc	min max	popcnt
shift_l(scalar) shift_l(vector)	shift_r(scalar) shift_r(vector)

 

template<unsigned N, class E1, class E2> Ret<N, _DETAIL_> sub_sat( Vec1<N,E1> a, Vec2<N,E2> b );

Performs saturated subtraction of two integer values. The implementation behaves as if the following set of overloads is provided:

Ret	Vec1	Vec2
int8	int8	int8
uint8	uint8	uint8
int16	int16	int16
uint16	uint16	uint16

The return type is a vector expression.

Scalar arguments

Several additional overloads are provided to implement implicit conversions from scalar types. Values of the following types are accepted as the first or the second argument: int32_t, int64_t, uint32_t, uint64_t. Each element of the expanded vector contains bitwise representation of the source value, with the highest bits discarded if the source data is too large.

The return type is a vector expression. The vector type is the same as the vector argument except that masks are unmasked to respective non-mask vector types.

Parameters

a, b

-

integer vectors

Return value

A vector expression evaluating to saturate(a - b).

Equivalent operation

r0 = saturate(a0 - b0)
...
rN = saturate(aN - bN)