_mm_shl_epi8

Article
08/10/2011

Visual Studio 2010 SP1 est requis

Spécifique à Microsoft

Génère le vpshlb de l'instruction XOP pour effectuer un décalage logique de chacun des octets dans sa première source en appliquant le degré spécifié dans la seconde.

__m128i _mm_shl_epi8 (
   __m128i src,
   __m128i counts
);

Paramètres

[in] src
Paramètre de 128 bits qui contient seize entiers non signés de 8 bits.
[in] counts
Paramètre de 128 bits qui contient seize entiers signés de 8 bits.

Valeur de retour

Résultat r de 128 bits qui contient seize entiers non signés de 8 bits.

r[i] := (counts[i] >= 0) ? src[i] << counts[i]) : 
                           src[i] >> -counts[i]);

Configuration requise

Intrinsèque	Architecture
_mm_shl_epi8	XOP

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

Notes

Chaque valeur de l'entier non signé de 8 bits dans src est décalée selon le nombre de bits spécifié dans la valeur correspondante dans counts, et le résultat de l'entier non signé de 8 bits est stocké comme valeur correspondante dans la destination. Si la valeur dans counts est positive, le décalage s'effectue à gauche (vers le bit le plus significatif) et les zéros sont décalés vers la fin à droite. Sinon, le décalage s'effectue à droite et les zéros sont décalés vers la fin à gauche. Si un compteur de décalage est supérieur à 7 ou inférieur à -7, la valeur du résultat correspondante est égale à 0.

L'instruction vpshlb 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, b, d;
    int i;
    for (i = 0; i < 16; i++) {
        a.m128i_u8[i] = (i << 4) | (15 - i);
        b.m128i_i8[i] = i - 8;
    }
    printf_s("data:       ");
    for (i = 0; i < 16; i++) printf_s(" %02x", a.m128i_u8[i]);
    printf_s("\nshifted by  ");
    for (i = 0; i < 16; i++) printf_s(" %2d", b.m128i_i8[i]);
    d = _mm_shl_epi8(a, b);
    printf_s("\ngives       ");
    for (i = 0; i < 16; i++) printf_s(" %02x", d.m128i_u8[i]);
    printf_s("\n");
}