_mm_com_epu8

Article
08/10/2011

Visual Studio 2010 SP1 est requis

Spécifique à Microsoft

Génère le vpcomub de l'instruction XOP pour retourner un masque de bits généré par une comparaison non signée octet-par-octet de ses deux premières sources à l'aide de la condition donnée par la troisième source.

__m128i _mm_com_epu8 (
   __m128i src1,
   __m128i src2,
   int condition
);

Paramètres

[in] src1
Tableau de 128 bits compressés de 16 entiers de 8 bits non signés.
[in] src2
Tableau de 128 bits compressés de 16 entiers de 8 bits non signés.
[in] condition
Condition de l'entier de 32 bits à utiliser dans la comparaison. Les valeurs autorisées sont comprises entre 0 et 7.

Valeur de retour

r du tableau de 128 bits compressés de 16 entiers de 8 bits non signés, chacun avec la valeur 0x00 ou 0xFF. Si cond est l'opérateur logique défini par la valeur de condition, alors

r[i] := src1[i] cond src2[i] ? 0xFF : 0x00;

Configuration requise

Intrinsèque	Architecture
_mm_com_epu8	XOP

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

Notes

Cette instruction compare chaque octet de src1 à l'octet correspondant de src2, à l'aide de l'opérateur de comparaison décrit par condition. (Chaque paire d'octets utilise le même opérateur de comparaison.) La condition des valeurs autorisées comprises entre 0 et 7. En incluant <intrin.h>, vous pouvez utiliser les noms suivants à la place des valeurs numériques de condition :

Valeur de type entier	Nom symbolique	Signification
0	_MM_PCOMCTRL_LT	r[i] = (src1[i] < src2[i]) ? 0xFF : 0x00
1	_MM_PCOMCTRL_LE	r[i] = (src1[i] <= src2[i]) ? 0xFF : 0x00
2	_MM_PCOMCTRL_GT	r[i] = (src1[i] > src2[i]) ? 0xFF : 0x00
3	_MM_PCOMCTRL_GE	r[i] = (src1[i] >= src2[i]) ? 0xFF : 0x00
4	_MM_PCOMCTRL_EQ	r[i] = (src1[i] == src2[i]) ? 0xFF : 0x00
5	_MM_PCOMCTRL_NEQ	r[i] = (src1[i] != src2[i]) ? 0xFF : 0x00
6	_MM_PCOMCTRL_FALSE	r[i] = 0x00 (masque de tous les zéros)
7	_MM_PCOMCTRL_TRUE	r[i] = 0xFF (masque de tous les zéros)

Si vous préférez, vous pouvez utiliser les macros suivantes qui seront définies lorsque < intrin.h > est inclus :

Macro	Signification
_mm_comlt_epu8(src1, src2)	_mm_com_epu8(src1, src2, 0)
_mm_comle_epu8(src1, src2)	_mm_com_epu8(src1, src2, 1)
_mm_comgt_epu8(src1, src2)	_mm_com_epu8(src1, src2, 2)
_mm_comge_epu8(src1, src2)	_mm_com_epu8(src1, src2, 3)
_mm_comeq_epu8(src1, src2)	_mm_com_epu8(src1, src2, 4)
_mm_comneq_epu8(src1, src2)	_mm_com_epu8(src1, src2, 5)
_mm_comfalse_epu8(src1, src2)	_mm_com_epu8(src1, src2, 6)
_mm_comtrue_epu8(src1, src2)	_mm_com_epu8(src1, src2, 7)

L'instruction vpcomub 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>
main()
{
   __m128i a, b, d;
    int i;
    for (i = 0; i < 16; i++) {
        a.m128i_i8[i] = ((11*i) % 31) - 16;
        b.m128i_i8[i] = ((13*i) % 31) - 16;
    }
    printf("src1:  ");
    for (i = 0; i < 16; i++) printf_s(" %3u", a.m128i_u8[i]);
    printf_s("\nsrc2:  ");
    for (i = 0; i < 16; i++) printf_s(" %3u", b.m128i_u8[i]);
    printf_s("\n< mask:");
    d = _mm_com_epu8(a, b, _MM_PCOMCTRL_LT);
    for (i = 0; i < 16; i++) printf_s("  %02x", d.m128i_u8[i]);
    printf_s("\n>=mask:");
    d = _mm_com_epu8(a, b, _MM_PCOMCTRL_GE);
    for (i = 0; i < 16; i++) printf_s("  %02x", d.m128i_u8[i]);
    printf("\n");
}