_mm_roti_epi16

Article
08/10/2011

Visual Studio 2010 SP1 est requis

Spécifique à Microsoft

Génère le vprotw de l'instruction XOP pour faire pivoter chacun des mots dans sa première source en appliquant le degré spécifié dans la seconde.

__m128i _mm_roti_epi16 (
   __m128i src,
   int count
);

Paramètres

[in] src
Un paramètre de 128 bits qui contient huit entiers de 16 bits non signés.
[in] count
Nombre de rotations de l'entier, de préférence constant.

Valeur de retour

Résultat r de 128 bits qui contient huit entiers non signés de 16 bits.

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

Configuration requise

Intrinsèque	Architecture
_mm_roti_epi16	XOP

Fichier d'en-tête <intrin.h>

Notes

Chaque valeur de l'entier non signé de 16 bits dans src est pivotée par le nombre de bits spécifié dans la valeur correspondante dans count, et le résultat de l'entier non signé de 16 bits est stocké comme valeur correspondante dans la destination. Si la valeur dans count est positive, la rotation s'effectue à gauche (vers le bit le plus significatif) ; sinon, la rotation s'effectue vers la droite.

L'instruction vprotw a un formulaire pour les arguments constants, un autre pour les arguments non constants. Si la valeur de count ne peut pas être déterminée comme une constante au moment de la compilation, le compilateur génère du code supplémentaire pour configurer et utiliser la version non constante de vprotw. La version constante de vprotw est plus rapide.

L'instruction vprotw fait partie de la famille XOP des instructions. Avant d'utiliser cette fonction intrinsèque, vous devez vérifier que le processeur prend en charge cette instruction. Pour déterminer la prise en charge du matériel pour cette instruction, appelez la fonction intrinsèque __cpuid avec InfoType = 0x80000001 et vérifiez le bit 11 de CPUInfo[2] (ECX). Ce bit est égal à 1 lorsque l'instruction est prise en charge, sinon il est égal à 0.

Exemple

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