_mm_roti_epi8

项目
08/12/2011

更新：2011 年 3 月

需要 Visual Studio 2010 SP1。

Microsoft 专用

生成 XOP 指令 vprotb 以旋转每个字节的第一个源中由第二个源指定的数量。

__m128i _mm_roti_epi8 (
   __m128i src,
   int count
);

参数

[in] src
包含十六个 8 位无符号整数的 128 位参数。
[in] count
整数旋转计数，最好是常数。

返回值

包含十六个 8 位无符号整数的 128 位结果 r。

r[i] := (count > 0) ? rotate_left(src[i], count) : 
                      rotate_right(src[i], -count);

要求

内部	体系结构
_mm_roti_epi8	XOP

头文件 <intrin.h>

备注

将 src 中的每个 8 位无符号整数值按照 count 中所指定的位数转动，并将该 8 位无符号整数结果存储为目标中相应的值。如果 count 中的值为正，则向左旋转（向最高有效位）；否则，向右旋转。

vprotb 指令有一个表单用于常数参数，另一个用于非常数参数。如果 count 中的值在编译时无法确定为常数，则该编译器将生成额外的代码来设置和使用 vprotb 的非常数版本。 vprotb 的常数版本速度更快。

vprotb 指令是 XOP 系列指令的一部分。在您使用此内部函数之前，必须确保处理器支持该指令。若要确定此指令的硬件支持，调用 InfoType = 0x80000001 的 __cpuid 内部函数并检查和 CPUInfo[2] (ECX) 的位 11。当该指令受支持时，此位为 1，否则为 0。

示例

#include <stdio.h>
#include <intrin.h>
int main()
{
    __m128i a, d;
    int i;
    for (i = 0; i < 16; i++) {
        a.m128i_u8[i] = (i << 4) | (15 - i);
    }
    d = _mm_roti_epi8(a, -3);
    printf_s("data:               ");
    for (i = 0; i < 16; i++) printf_s(" %02x", a.m128i_u8[i]);
    printf_s("\nrotated by -3 gives ");
    for (i = 0; i < 16; i++) printf_s(" %02x", d.m128i_u8[i]);
    printf_s("\n");
}