_mm_cmpistrm

Artikel
03/05/2012

[Diese Dokumentation ist nur eine Vorschau und wird in späteren Versionen ggf. geändert. Blank topics are included as placeholders.]

Microsoft-spezifisch

Gibt die Anweisung pcmpistrmder Streaming SIMD-Erweiterungen 4 (SSE4) aus. Diese Anweisung vergleicht zwei Parameter.

__m128i _mm_cmpistrm (
   __m128i a, 
   __m128i b, 
   const int mode
);

Parameter

Parameter	Beschreibung
[in] a	Ein Zeichenfolgen fragment mit einer maximalen Größe von 16 Byte pro Zeichen oder 8 Wortzeichen.
[in] b	Ein Zeichenfolgen fragment mit einer maximalen Größe von 16 Byte pro Zeichen oder 8 Wortzeichen.
[in] mode	Eine Konstante, die angibt, ob Zeichen oder Bytes Wörter, der Typ des Vergleichs sind, und das Format des zurückgegebenen Werts.

Rückgabewert

Entweder die berechnete Maske von MaxSize Bits oder dessen Erweiterung eines 128-Bit-Parameter. Wenn der Rückgabewert erweitert wird, wird jedes Bit der Ergebnis maske in ein Byte eines Worts oder erweitert.

Die pcmpistrm Ergebnis berechnet die Anweisung, in der maske bit0, bit1, bit2… in der Maske auf das Ergebnis des Vorgangs auf a0, a1, a2… in aentsprechen.

Anforderungen

Intrinsisch	Architektur
_mm_cmpistrm	x86, x64

Headerdatei <nmmintrin.h>

Hinweise

b0, b1, b2… gibt das erste, zweite und dritte… Zeichen in ban. b0 wird in den niedrigstwertigen Byte aus bgespeichert. Dieselbe Schreibweise bezieht sich auf a. MaxSize ist entweder 16 oder 8 Byte pro Zeichen für Zeichen für Wortzeichen. Dies ist die maximale Anzahl von Zeichen, die in __m128i einen Datentyp passen. Die unteren 7 Bits in mode bestimmen den Typ der Eingabezeichen, die den Vergleich ausgeführt und das Format des Rückgabewerts. Sie werden im Folgenden beschrieben:

mode in der Binärdatei	Vordefinierte Konstante	Beschreibung
xxxxxx00	_SIDD_UBYTE_OPS	a und aus Zeichenfolgen enthalten b 8-Bit-Zeichen ohne Vorzeichen.
xxxxxx01	_SIDD_UWORD_OPS	a und b enthalten Zeichenfolgen aus 16-Bit-Zeichen ohne Vorzeichen.
xxxxxx10	_SIDD_SBYTE_OPS	a und aus Zeichenfolgen enthalten b 8-Bit-Zeichen mit Vorzeichen.
xxxxxx11	_SIDD_SWORD_OPS	a und b enthalten Zeichenfolgen aus 16-Bit-Zeichen mit Vorzeichen.
xxxx00xx	_SIDD_CMP_EQUAL_ANY	Suchen, wenn gleich einem Modus: Für jedes Zeichen in ca, bestimmen Sie, ob ein Zeichen in b gleich cist.
xxxx01xx	_SIDD_CMP_RANGES	Suchen Sie im Bereichsmodus: Für jedes Zeichen in cabestimmen, ob Sie b0 <= c <= b1order b2 <= c <= b3…
xxxx10xx	_SIDD_CMP_EQUAL_EACH	Suchen, wenn gleich jeder Modus: Diese Zeichenfolgen gleichheits Algorithmus implementiert.
xxxx11xx	_SIDD_CMP_EQUAL_ORDERED	Suchen, wenn gleicher geordneter Modus: Dieses implementiert den Teilzeichenfolgen suchende Algorithmus.
xxx0xxxx	_SIDD_POSITIVE_POLARITY	Keine Auswirkung.
xx01xxxx	_SIDD_NEGATIVE_POLARITY	Negation der resultierenden Bitmaske.
xx11xxxx	_SIDD_MASKED_NEGATIVE_POLARITY	Negation der resultierenden Bitmaske außer Bits, die einen Index verfügen, der größer ist als die Größe von a oder b (siehe Details pcmpstrm Statement).
x0xxxxxx	_SIDD_BIT_MASK	Die maske Ergebnis wird zurückgegeben.
x1xxxxxx	_SIDD_UNIT_MASK	Jedes Bit im Ergebnis maske ist auf 16 Bytes oder 8 Wörtern erweitert wird, bevor er zurückgegeben wird.