Word description Converts SIMD vectors of from-type to to-type. The number of inputs and outputs depends on the relationship of the two types:
•
If to-type is a floating-point vector type with the same byte length and element count as the integer vector type from-type (for example, from int-4 to float-4 or from longlong-2 to double-2), vconvert takes one vector of from-type and converts its elements to floating-point, outputting one vector of to-type.
•
Likewise, if to-type is an integer vector type with the same byte length and element count as the floating-point vector type from-type, vconvert takes one vector of from-type and truncates its elements to integers, outputting one vector of to-type.
•
If to-type is a vector type with the same byte length as and twice the element count of the vector type from-type (for example, from int-4 to ushort-8, from double-2 to float-4, or from short-8 to char-16), vconvert takes two vectors of from-type and packs them into one vector of to-type, saturating values too large or small to be representable as elements of to-type.
•
If to-type is a vector type with the same byte length as and half the element count of the vector type from-type (for example, from ushort-8 to int-4, from float-4 to double-2, or from char-16 to short-8), vconvert takes one vector of from-type and unpacks it into two vectors of to-type.
from-type and to-type must adhere to the following restrictions; a bad-vconvert error will be thrown otherwise:
•
from-type and to-type must have the same byte length. You cannot currently convert between 128- and 256-bit vector types.
•
For conversions between floating-point and integer vectors, from-type and to-type must have the same element length.
•
For packing conversions, from-type and to-type must be both floating-point or both integer types. Integer types can be packed from signed to unsigned or from unsigned to unsigned types. Unsigned to signed packing is invalid.
•
For unpacking conversions, from-type and to-type must be both floating-point or both integer types. Integer types can be unpacked from unsigned to signed or from unsigned to unsigned types. Signed to unsigned unpacking is invalid.
Examples Conversion between integer and float vectors: