_mm_cmpistrz

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_cmpistrz (
   __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

Gibt ein zurück, wenn das NULL-Zeichen in bauftritt. Andernfalls Null. Wenn zurückgegeben wird, bedeutet dies, dass b das Ende fragment der Zeichenfolge enthält, die verglichen werden soll.

Anforderungen

Intrinsisch	Architektur
_mm_cmpistrz	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 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.
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 pcmpistri Statement).