_mm_cmpestri

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 pcmpestrider Streaming SIMD-Erweiterungen 4 (SSE4) aus. Diese Anweisung vergleicht zwei Parameter.

int _mm_cmpestri (
   __m128i a, 
   int la,
   __m128i b,
   int lb, 
   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] la	Eine ganze Zahl, die die Größe der Zeichenfolge in aangibt.
[in] b	Ein Zeichenfolgen fragment mit einer maximalen Größe von 16 Byte pro Zeichen oder 8 Wortzeichen.
[in] lb	Eine ganze Zahl, die die Größe der Zeichenfolge in b.angibt
[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

Eine ganze Zahl zwischen 0 und MaxSizesich erstreckt. Maxsize wird zurückgegeben, wenn die resultierende Bitmaske gleich 0 ist. Andernfalls wird der Index entweder des am weitesten links stehenden oder am weitesten rechts befindende Bits in dieser Maske auf 1 festgelegt. Der Eingabeparameter mode bestimmt, ob das sich am weitesten links befindende oder am weitesten rechts befindende Bit zurückgibt.

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

Anforderungen

Intrinsisch	Architektur
_mm_cmpestri	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. MaxSize ist die maximale Anzahl von Zeichen, die in __m128i einen Datentyp passen. Die unteren 7 Bits bestimmen mode Eingabezeichen, der den Typ des Vergleichs, der ausgeführt werden soll, und des Formats des Rückgabewerts. Sie werden in der folgenden Tabelle beschrieben:

mode in der Binärdatei	Definierte 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 oderb(siehe Details pcmpestri Statement).
x0xxxxxx	_SIDD_LEAST_SIGNIFICANT	Der Index des sich am weitesten rechts befindende Bits auf 1 festgelegt ist, wird zurückgegeben.
x1xxxxxx	_SIDD_MOST_SIGNIFICANT	Der Index des am weitesten links stehenden Bits auf 1 festgelegt ist, wird zurückgegeben.