_mm_roti_epi16

Artikel
07/20/2011

Visual Studio 2010 SP1 wird benötigt.

Microsoft-spezifisch

Generiert die XOP-Anweisung vprotw, um jedes Wort der ersten Quelle um den in der zweiten Quelle angegebenen Wert zu rotieren.

__m128i _mm_roti_epi16 (
   __m128i src,
   int count
);

Parameter

[in] src
Ein 128-Bit-Parameter, der acht 16-Bit-Ganzzahlen ohne Vorzeichen enthält.
[in] count
Eine Ganzzahl für die Drehung, vorzugsweise eine Konstante.

Rückgabewert

Ein 128-Bit-Ergebnis r, das acht 16-Bit-Ganzzahlen ohne Vorzeichen enthält.

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

Anforderungen

Intrinsisch	Architektur
_mm_roti_epi16	XOP

Headerdatei <intrin.h>

Hinweise

Jeder 16-Bit-Ganzzahlwert ohne Vorzeichen in src wird um die in count angegebene Anzahl Bits gedreht, und das 16-Bit-Ganzzahlergebnis ohne Vorzeichen wird als zugehöriger Wert im Ziel gespeichert. Wenn der Wert in count positiv ist, ist die Drehungsrichtung nach links (zum höchstwertigen Byte); andernfalls ist sie nach rechts.

Die vprotw-Anweisung unterstützt eine Form für konstante Argumente und eine Form für nicht konstante Argumente. Wenn der Wert von count nicht als zur Kompilierzeit konstant ermittelt werden kann, generiert der Compiler zusätzlichen Code, um die nicht konstante Version von vprotw einzurichten und zu verwenden. Die konstante Version von vprotw ist schneller.

Die vprotw-Anweisung ist Teil der XOP-Anweisungsfamilie. Bevor Sie diese systeminterne Funktion verwenden, müssen Sie sicherstellen, dass der Prozessor diese Anweisung unterstützt. Um die Hardwareunterstützung für diese Anweisung zu bestimmen, rufen Sie die systeminterne Funktion __cpuid mit InfoType = 0x80000001 auf, und prüfen Sie Bit 11 von CPUInfo[2] (ECX). Dieses Bit ist 1, wenn die Anweisung unterstützt wird, und andernfalls 0.

Beispiel

#include <stdio.h>
#include <intrin.h>
int main()
{
    __m128i a, d;
    int i;
    for (i = 0; i < 8; i++) {
        a.m128i_u16[i] = (2*(i+1)) << 12 | (15 - 2*(i+1)) << 8 |
                          2*i << 4 | (15 - 2*i);
    }
    d = _mm_roti_epi16(a, 12);
    printf_s("data:              ");
    for (i = 0; i < 8; i++) printf_s(" %04x", a.m128i_u16[i]);
    printf_s("\nrotated by 12 gives");
    for (i = 0; i < 8; i++) printf_s(" %04x", d.m128i_u16[i]);
    printf_s("\n");
}