_mm_roti_epi8

更新：2011 年 3 月

必須有 Visual Studio 2010 SP1。

Microsoft 專有的

產生 XOP 指令 vprotb，按照第二個來源指定的數量旋轉其第一個來源中的每個位元組。

__m128i _mm_roti_epi8 (
   __m128i src,
   int count
);

參數

[in] src
128 位元參數，這個參數包含十六個 8 位元不帶正負號的整數。
[in] count
整數旋轉計數，最好是常數。

傳回值

128 位元結果 r，這個結果包含十六個 8 位元不帶正負號的整數。

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");
}