Sophie: rust-doc-1.28.0-1.mga6 armv7hl

rust-doc-1.28.0-1.mga6.armv7hl.rpm

<!DOCTYPE html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><meta name="generator" content="rustdoc"><meta name="description" content="API documentation for the Rust `_mm_cmpistri` fn in crate `core`."><meta name="keywords" content="rust, rustlang, rust-lang, _mm_cmpistri"><title>core::arch::x86::_mm_cmpistri - Rust</title><link rel="stylesheet" type="text/css" href="../../../normalize.css"><link rel="stylesheet" type="text/css" href="../../../rustdoc.css" id="mainThemeStyle"><link rel="stylesheet" type="text/css" href="../../../dark.css"><link rel="stylesheet" type="text/css" href="../../../light.css" id="themeStyle"><script src="../../../storage.js"></script><link rel="shortcut icon" href="https://doc.rust-lang.org/favicon.ico"></head><body class="rustdoc fn"><!--[if lte IE 8]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><nav class="sidebar"><div class="sidebar-menu">&#9776;</div><a href='../../../core/index.html'><img src='https://www.rust-lang.org/logos/rust-logo-128x128-blk-v2.png' alt='logo' width='100'></a><div class="sidebar-elems"><p class='location'><a href='../../index.html'>core</a>::<wbr><a href='../index.html'>arch</a>::<wbr><a href='index.html'>x86</a></p><script>window.sidebarCurrent = {name: '_mm_cmpistri', ty: 'fn', relpath: ''};</script><script defer src="sidebar-items.js"></script></div></nav><div class="theme-picker"><button id="theme-picker" aria-label="Pick another theme!"><img src="../../../brush.svg" width="18" alt="Pick another theme!"></button><div id="theme-choices"></div></div><script src="../../../theme.js"></script><nav class="sub"><form class="search-form js-only"><div class="search-container"><input class="search-input" name="search" autocomplete="off" placeholder="Click or press ‘S’ to search, ‘?’ for more options…" type="search"><a id="settings-menu" href="../../../settings.html"><img src="../../../wheel.svg" width="18" alt="Change settings"></a></div></form></nav><section id="main" class="content"><h1 class='fqn'><span class='in-band'>Function <a href='../../index.html'>core</a>::<wbr><a href='../index.html'>arch</a>::<wbr><a href='index.html'>x86</a>::<wbr><a class="fn" href=''>_mm_cmpistri</a></span><span class='out-of-band'><span class='since' title='Stable since Rust version 1.27.0'>1.27.0</span><span id='render-detail'><a id="toggle-all-docs" href="javascript:void(0)" title="collapse all docs">[<span class='inner'>&#x2212;</span>]</a></span><a class='srclink' href='../../../src/core/up/stdsimd/coresimd/x86/sse42.rs.html#317-326' title='goto source code'>[src]</a></span></h1><pre class='rust fn'>pub unsafe fn _mm_cmpistri(a: <a class="struct" href="../../../core/arch/x86/struct.__m128i.html" title="struct core::arch::x86::__m128i">__m128i</a>, b: <a class="struct" href="../../../core/arch/x86/struct.__m128i.html" title="struct core::arch::x86::__m128i">__m128i</a>, imm8: i32) -&gt; i32</pre><div class='stability'><div class='stab portability'>This is supported on <strong>x86 and target feature <code>sse4.2</code></strong> only.</div></div><div class='docblock'><p>Compare packed strings with implicit lengths in <code>a</code> and <code>b</code> using the
control in <code>imm8</code> and return the generated index. Similar to
<a href="fn._mm_cmpestri.html"><code>_mm_cmpestri</code></a> with the exception that <a href="fn._mm_cmpestri.html"><code>_mm_cmpestri</code></a> requires the
lengths of <code>a</code> and <code>b</code> to be explicitly specified.</p>
<h1 id="control-modes" class="section-header"><a href="#control-modes">Control modes</a></h1>
<p>The control specified by <code>imm8</code> may be one or more of the following.</p>
<h2 id="data-size-and-signedness" class="section-header"><a href="#data-size-and-signedness">Data size and signedness</a></h2>
<ul>
<li><a href="constant._SIDD_UBYTE_OPS.html"><code>_SIDD_UBYTE_OPS</code></a> - Default</li>
<li><a href="constant._SIDD_UWORD_OPS.html"><code>_SIDD_UWORD_OPS</code></a></li>
<li><a href="constant._SIDD_SBYTE_OPS.html"><code>_SIDD_SBYTE_OPS</code></a></li>
<li><a href="constant._SIDD_SWORD_OPS.html"><code>_SIDD_SWORD_OPS</code></a></li>
</ul>
<h2 id="comparison-options" class="section-header"><a href="#comparison-options">Comparison options</a></h2>
<ul>
<li><a href="constant._SIDD_CMP_EQUAL_ANY.html"><code>_SIDD_CMP_EQUAL_ANY</code></a> - Default</li>
<li><a href="constant._SIDD_CMP_RANGES.html"><code>_SIDD_CMP_RANGES</code></a></li>
<li><a href="constant._SIDD_CMP_EQUAL_EACH.html"><code>_SIDD_CMP_EQUAL_EACH</code></a></li>
<li><a href="constant._SIDD_CMP_EQUAL_ORDERED.html"><code>_SIDD_CMP_EQUAL_ORDERED</code></a></li>
</ul>
<h2 id="result-polarity" class="section-header"><a href="#result-polarity">Result polarity</a></h2>
<ul>
<li><a href="constant._SIDD_POSITIVE_POLARITY.html"><code>_SIDD_POSITIVE_POLARITY</code></a> - Default</li>
<li><a href="constant._SIDD_NEGATIVE_POLARITY.html"><code>_SIDD_NEGATIVE_POLARITY</code></a></li>
</ul>
<h2 id="bit-returned" class="section-header"><a href="#bit-returned">Bit returned</a></h2>
<ul>
<li><a href="constant._SIDD_LEAST_SIGNIFICANT.html"><code>_SIDD_LEAST_SIGNIFICANT</code></a> - Default</li>
<li><a href="constant._SIDD_MOST_SIGNIFICANT.html"><code>_SIDD_MOST_SIGNIFICANT</code></a></li>
</ul>
<h1 id="examples" class="section-header"><a href="#examples">Examples</a></h1>
<p>Find a substring using <a href="constant._SIDD_CMP_EQUAL_ORDERED.html"><code>_SIDD_CMP_EQUAL_ORDERED</code></a></p>

<pre class="rust rust-example-rendered">
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">target_arch</span> <span class="op">=</span> <span class="string">&quot;x86&quot;</span>)]</span>
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">arch</span>::<span class="ident">x86</span>::<span class="kw-2">*</span>;
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">target_arch</span> <span class="op">=</span> <span class="string">&quot;x86_64&quot;</span>)]</span>
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">arch</span>::<span class="ident">x86_64</span>::<span class="kw-2">*</span>;

<span class="kw">let</span> <span class="ident">haystack</span> <span class="op">=</span> <span class="string">b&quot;This is a long string of text data\r\n\tthat extends
multiple lines&quot;</span>;
<span class="kw">let</span> <span class="ident">needle</span> <span class="op">=</span> <span class="string">b&quot;\r\n\t\0\0\0\0\0\0\0\0\0\0\0\0\0&quot;</span>;

<span class="kw">let</span> <span class="ident">a</span> <span class="op">=</span> <span class="ident">_mm_loadu_si128</span>(<span class="ident">needle</span>.<span class="ident">as_ptr</span>() <span class="kw">as</span> <span class="kw-2">*</span><span class="kw">const</span> <span class="kw">_</span>);
<span class="kw">let</span> <span class="ident">hop</span> <span class="op">=</span> <span class="number">16</span>;
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">indexes</span> <span class="op">=</span> <span class="ident">Vec</span>::<span class="ident">new</span>();

<span class="comment">// Chunk the haystack into 16 byte chunks and find</span>
<span class="comment">// the first &quot;\r\n\t&quot; in the chunk.</span>
<span class="kw">for</span> (<span class="ident">i</span>, <span class="ident">chunk</span>) <span class="kw">in</span> <span class="ident">haystack</span>.<span class="ident">chunks</span>(<span class="ident">hop</span>).<span class="ident">enumerate</span>() {
    <span class="kw">let</span> <span class="ident">b</span> <span class="op">=</span> <span class="ident">_mm_loadu_si128</span>(<span class="ident">chunk</span>.<span class="ident">as_ptr</span>() <span class="kw">as</span> <span class="kw-2">*</span><span class="kw">const</span> <span class="kw">_</span>);
    <span class="kw">let</span> <span class="ident">idx</span> <span class="op">=</span> <span class="ident">_mm_cmpistri</span>(<span class="ident">a</span>, <span class="ident">b</span>, <span class="ident">_SIDD_CMP_EQUAL_ORDERED</span>);
    <span class="kw">if</span> <span class="ident">idx</span> <span class="op">!=</span> <span class="number">16</span> {
       <span class="ident">indexes</span>.<span class="ident">push</span>((<span class="ident">idx</span> <span class="kw">as</span> <span class="ident">usize</span>) <span class="op">+</span> (<span class="ident">i</span> <span class="op">*</span> <span class="ident">hop</span>));
    }
}
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">indexes</span>, <span class="macro">vec</span><span class="macro">!</span>[<span class="number">34</span>]);<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=%23!%5Ballow(unused)%5D%0A%23!%5Bfeature(stdsimd)%5D%0A%23!%5Bcfg_attr(not(dox)%2C%20no_std)%5D%0A%23%5Bcfg(not(dox))%5D%0A%23%5Bmacro_use%5D%0Aextern%20crate%20std%20as%20real_std%3B%0A%23%5Bcfg(not(dox))%5D%0A%23%5Bmacro_use%5D%0Aextern%20crate%20stdsimd%20as%20std%3B%0A%23%5Bcfg(not(dox))%5D%0Ause%20real_std%3A%3Aprelude%3A%3Av1%3A%3A*%3B%0A%23%5Bcfg(target_arch%20%3D%20%22x86%22)%5D%0Ause%20std%3A%3Aarch%3A%3Ax86%3A%3A*%3B%0A%23%5Bcfg(target_arch%20%3D%20%22x86_64%22)%5D%0Ause%20std%3A%3Aarch%3A%3Ax86_64%3A%3A*%3B%0A%0Afn%20main()%20%7B%0A%20%20%20%20if%20is_x86_feature_detected!(%22sse4.2%22)%20%7B%0A%20%20%20%20%20%20%20%20%23%5Btarget_feature(enable%20%3D%20%22sse4.2%22)%5D%0A%20%20%20%20%20%20%20%20unsafe%20fn%20worker()%20%7B%0Alet%20haystack%20%3D%20b%22This%20is%20a%20long%20string%20of%20text%20data%5Cr%5Cn%5Ctthat%20extends%0Amultiple%20lines%22%3B%0Alet%20needle%20%3D%20b%22%5Cr%5Cn%5Ct%5C0%5C0%5C0%5C0%5C0%5C0%5C0%5C0%5C0%5C0%5C0%5C0%5C0%22%3B%0A%0Alet%20a%20%3D%20_mm_loadu_si128(needle.as_ptr()%20as%20*const%20_)%3B%0Alet%20hop%20%3D%2016%3B%0Alet%20mut%20indexes%20%3D%20Vec%3A%3Anew()%3B%0A%0A%2F%2F%20Chunk%20the%20haystack%20into%2016%20byte%20chunks%20and%20find%0A%2F%2F%20the%20first%20%22%5Cr%5Cn%5Ct%22%20in%20the%20chunk.%0Afor%20(i%2C%20chunk)%20in%20haystack.chunks(hop).enumerate()%20%7B%0A%20%20%20%20let%20b%20%3D%20_mm_loadu_si128(chunk.as_ptr()%20as%20*const%20_)%3B%0A%20%20%20%20let%20idx%20%3D%20_mm_cmpistri(a%2C%20b%2C%20_SIDD_CMP_EQUAL_ORDERED)%3B%0A%20%20%20%20if%20idx%20!%3D%2016%20%7B%0A%20%20%20%20%20%20%20indexes.push((idx%20as%20usize)%20%2B%20(i%20*%20hop))%3B%0A%20%20%20%20%7D%0A%7D%0Aassert_eq!(indexes%2C%20vec!%5B34%5D)%3B%0A%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%20%20unsafe%20%7B%20worker()%3B%20%7D%0A%20%20%20%20%7D%0A%7D&amp;version=nightly">Run</a></pre>
<p>The <code>_mm_cmpistri</code> intrinsic may also be used to find the existance of
one or more of a given set of characters in the haystack.</p>

<pre class="rust rust-example-rendered">
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">target_arch</span> <span class="op">=</span> <span class="string">&quot;x86&quot;</span>)]</span>
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">arch</span>::<span class="ident">x86</span>::<span class="kw-2">*</span>;
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">target_arch</span> <span class="op">=</span> <span class="string">&quot;x86_64&quot;</span>)]</span>
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">arch</span>::<span class="ident">x86_64</span>::<span class="kw-2">*</span>;

<span class="comment">// Ensure your input is 16 byte aligned</span>
<span class="kw">let</span> <span class="ident">password</span> <span class="op">=</span> <span class="string">b&quot;hunter2\0\0\0\0\0\0\0\0\0&quot;</span>;
<span class="kw">let</span> <span class="ident">special_chars</span> <span class="op">=</span> <span class="string">b&quot;!@#$%^&amp;*()[]:;&lt;&gt;&quot;</span>;

<span class="comment">// Load the input</span>
<span class="kw">let</span> <span class="ident">a</span> <span class="op">=</span> <span class="ident">_mm_loadu_si128</span>(<span class="ident">special_chars</span>.<span class="ident">as_ptr</span>() <span class="kw">as</span> <span class="kw-2">*</span><span class="kw">const</span> <span class="kw">_</span>);
<span class="kw">let</span> <span class="ident">b</span> <span class="op">=</span> <span class="ident">_mm_loadu_si128</span>(<span class="ident">password</span>.<span class="ident">as_ptr</span>() <span class="kw">as</span> <span class="kw-2">*</span><span class="kw">const</span> <span class="kw">_</span>);

<span class="comment">// Use _SIDD_CMP_EQUAL_ANY to find the index of any bytes in b</span>
<span class="kw">let</span> <span class="ident">idx</span> <span class="op">=</span> <span class="ident">_mm_cmpistri</span>(<span class="ident">a</span>.<span class="ident">into</span>(), <span class="ident">b</span>.<span class="ident">into</span>(), <span class="ident">_SIDD_CMP_EQUAL_ANY</span>);

<span class="kw">if</span> <span class="ident">idx</span> <span class="op">&lt;</span> <span class="number">16</span> {
    <span class="macro">println</span><span class="macro">!</span>(<span class="string">&quot;Congrats! Your password contains a special character&quot;</span>);
} <span class="kw">else</span> {
    <span class="macro">println</span><span class="macro">!</span>(<span class="string">&quot;Your password should contain a special character&quot;</span>);
}<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=%23!%5Ballow(unused)%5D%0A%23!%5Bfeature(stdsimd)%5D%0A%23!%5Bcfg_attr(not(dox)%2C%20no_std)%5D%0A%23%5Bcfg(not(dox))%5D%0A%23%5Bmacro_use%5D%0Aextern%20crate%20std%20as%20real_std%3B%0A%23%5Bcfg(not(dox))%5D%0A%23%5Bmacro_use%5D%0Aextern%20crate%20stdsimd%20as%20std%3B%0A%23%5Bcfg(target_arch%20%3D%20%22x86%22)%5D%0Ause%20std%3A%3Aarch%3A%3Ax86%3A%3A*%3B%0A%23%5Bcfg(target_arch%20%3D%20%22x86_64%22)%5D%0Ause%20std%3A%3Aarch%3A%3Ax86_64%3A%3A*%3B%0A%0Afn%20main()%20%7B%0A%20%20%20%20if%20is_x86_feature_detected!(%22sse4.2%22)%20%7B%0A%20%20%20%20%20%20%20%20%23%5Btarget_feature(enable%20%3D%20%22sse4.2%22)%5D%0A%20%20%20%20%20%20%20%20unsafe%20fn%20worker()%20%7B%0A%2F%2F%20Ensure%20your%20input%20is%2016%20byte%20aligned%0Alet%20password%20%3D%20b%22hunter2%5C0%5C0%5C0%5C0%5C0%5C0%5C0%5C0%5C0%22%3B%0Alet%20special_chars%20%3D%20b%22!%40%23%24%25%5E%26*()%5B%5D%3A%3B%3C%3E%22%3B%0A%0A%2F%2F%20Load%20the%20input%0Alet%20a%20%3D%20_mm_loadu_si128(special_chars.as_ptr()%20as%20*const%20_)%3B%0Alet%20b%20%3D%20_mm_loadu_si128(password.as_ptr()%20as%20*const%20_)%3B%0A%0A%2F%2F%20Use%20_SIDD_CMP_EQUAL_ANY%20to%20find%20the%20index%20of%20any%20bytes%20in%20b%0Alet%20idx%20%3D%20_mm_cmpistri(a.into()%2C%20b.into()%2C%20_SIDD_CMP_EQUAL_ANY)%3B%0A%0Aif%20idx%20%3C%2016%20%7B%0A%20%20%20%20println!(%22Congrats!%20Your%20password%20contains%20a%20special%20character%22)%3B%0Apanic!(%22%7B%3A%3F%7D%20does%20not%20contain%20a%20special%20character%22%2C%20password)%3B%0A%7D%20else%20%7B%0A%20%20%20%20println!(%22Your%20password%20should%20contain%20a%20special%20character%22)%3B%0A%7D%0A%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%20%20unsafe%20%7B%20worker()%3B%20%7D%0A%20%20%20%20%7D%0A%7D&amp;version=nightly">Run</a></pre>
<p>Find the index of the first character in the haystack that is within a
range of characters.</p>

<pre class="rust rust-example-rendered">
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">target_arch</span> <span class="op">=</span> <span class="string">&quot;x86&quot;</span>)]</span>
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">arch</span>::<span class="ident">x86</span>::<span class="kw-2">*</span>;
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">target_arch</span> <span class="op">=</span> <span class="string">&quot;x86_64&quot;</span>)]</span>
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">arch</span>::<span class="ident">x86_64</span>::<span class="kw-2">*</span>;


<span class="comment">// Specify the ranges of values to be searched for [A-Za-z0-9].</span>
<span class="kw">let</span> <span class="ident">a</span> <span class="op">=</span> <span class="string">b&quot;AZaz09\0\0\0\0\0\0\0\0\0\0&quot;</span>;
<span class="kw">let</span> <span class="ident">a</span> <span class="op">=</span> <span class="ident">_mm_loadu_si128</span>(<span class="ident">a</span>.<span class="ident">as_ptr</span>() <span class="kw">as</span> <span class="kw-2">*</span><span class="kw">const</span> <span class="kw">_</span>);

<span class="comment">// Use _SIDD_CMP_RANGES to find the index of first byte in ranges.</span>
<span class="comment">// Which in this case will be the first alpha numeric byte found</span>
<span class="comment">// in the string.</span>
<span class="kw">let</span> <span class="ident">idx</span> <span class="op">=</span> <span class="ident">_mm_cmpistri</span>(<span class="ident">a</span>, <span class="ident">b</span>, <span class="ident">_SIDD_CMP_RANGES</span>);

<span class="kw">if</span> <span class="ident">idx</span> <span class="op">&lt;</span> <span class="number">16</span> {
    <span class="macro">println</span><span class="macro">!</span>(<span class="string">&quot;Found an alpha numeric character&quot;</span>);
} <span class="kw">else</span> {
    <span class="macro">println</span><span class="macro">!</span>(<span class="string">&quot;Did not find an alpha numeric character&quot;</span>);
}<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=%23!%5Ballow(unused)%5D%0A%23!%5Bfeature(stdsimd)%5D%0A%23!%5Bcfg_attr(not(dox)%2C%20no_std)%5D%0A%23%5Bcfg(not(dox))%5D%0A%23%5Bmacro_use%5D%0Aextern%20crate%20std%20as%20real_std%3B%0A%23%5Bcfg(not(dox))%5D%0A%23%5Bmacro_use%5D%0Aextern%20crate%20stdsimd%20as%20std%3B%0A%23%5Bcfg(target_arch%20%3D%20%22x86%22)%5D%0Ause%20std%3A%3Aarch%3A%3Ax86%3A%3A*%3B%0A%23%5Bcfg(target_arch%20%3D%20%22x86_64%22)%5D%0Ause%20std%3A%3Aarch%3A%3Ax86_64%3A%3A*%3B%0A%0Afn%20main()%20%7B%0A%20%20%20%20if%20is_x86_feature_detected!(%22sse4.2%22)%20%7B%0A%20%20%20%20%20%20%20%20%23%5Btarget_feature(enable%20%3D%20%22sse4.2%22)%5D%0A%20%20%20%20%20%20%20%20unsafe%20fn%20worker()%20%7B%0Alet%20b%20%3D%20b%22%3A%3B%3C%3D%3E%3F%40%5B%5C%5C%5D%5E_%60abc%22%3B%0Alet%20b%20%3D%20_mm_loadu_si128(b.as_ptr()%20as%20*const%20_)%3B%0A%0A%2F%2F%20Specify%20the%20ranges%20of%20values%20to%20be%20searched%20for%20%5BA-Za-z0-9%5D.%0Alet%20a%20%3D%20b%22AZaz09%5C0%5C0%5C0%5C0%5C0%5C0%5C0%5C0%5C0%5C0%22%3B%0Alet%20a%20%3D%20_mm_loadu_si128(a.as_ptr()%20as%20*const%20_)%3B%0A%0A%2F%2F%20Use%20_SIDD_CMP_RANGES%20to%20find%20the%20index%20of%20first%20byte%20in%20ranges.%0A%2F%2F%20Which%20in%20this%20case%20will%20be%20the%20first%20alpha%20numeric%20byte%20found%0A%2F%2F%20in%20the%20string.%0Alet%20idx%20%3D%20_mm_cmpistri(a%2C%20b%2C%20_SIDD_CMP_RANGES)%3B%0A%0Aif%20idx%20%3C%2016%20%7B%0A%20%20%20%20println!(%22Found%20an%20alpha%20numeric%20character%22)%3B%0Aassert_eq!(idx%2C%2013)%3B%0A%7D%20else%20%7B%0A%20%20%20%20println!(%22Did%20not%20find%20an%20alpha%20numeric%20character%22)%3B%0A%7D%0A%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%20%20unsafe%20%7B%20worker()%3B%20%7D%0A%20%20%20%20%7D%0A%7D&amp;version=nightly">Run</a></pre>
<p>Working with 16-bit characters.</p>

<pre class="rust rust-example-rendered">
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">target_arch</span> <span class="op">=</span> <span class="string">&quot;x86&quot;</span>)]</span>
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">arch</span>::<span class="ident">x86</span>::<span class="kw-2">*</span>;
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">target_arch</span> <span class="op">=</span> <span class="string">&quot;x86_64&quot;</span>)]</span>
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">arch</span>::<span class="ident">x86_64</span>::<span class="kw-2">*</span>;

<span class="comment">// Load the input</span>
<span class="kw">let</span> <span class="ident">a</span> <span class="op">=</span> <span class="ident">_mm_loadu_si128</span>(<span class="ident">some_utf16_words</span>.<span class="ident">as_ptr</span>() <span class="kw">as</span> <span class="kw-2">*</span><span class="kw">const</span> <span class="kw">_</span>);
<span class="kw">let</span> <span class="ident">b</span> <span class="op">=</span> <span class="ident">_mm_loadu_si128</span>(<span class="ident">more_utf16_words</span>.<span class="ident">as_ptr</span>() <span class="kw">as</span> <span class="kw-2">*</span><span class="kw">const</span> <span class="kw">_</span>);

<span class="comment">// Specify _SIDD_UWORD_OPS to compare words instead of bytes, and</span>
<span class="comment">// use _SIDD_CMP_EQUAL_EACH to compare the two strings.</span>
<span class="kw">let</span> <span class="ident">idx</span> <span class="op">=</span> <span class="ident">_mm_cmpistri</span>(<span class="ident">a</span>, <span class="ident">b</span>, <span class="ident">_SIDD_UWORD_OPS</span> <span class="op">|</span> <span class="ident">_SIDD_CMP_EQUAL_EACH</span>);

<span class="kw">if</span> <span class="ident">idx</span> <span class="op">==</span> <span class="number">0</span> {
    <span class="macro">println</span><span class="macro">!</span>(<span class="string">&quot;16-bit unicode strings were equal!&quot;</span>);
} <span class="kw">else</span> {
    <span class="macro">println</span><span class="macro">!</span>(<span class="string">&quot;16-bit unicode strings were not equal!&quot;</span>);
}<a class="test-arrow" target="_blank" href="https://play.rust-lang.org/?code=%23!%5Ballow(unused)%5D%0A%23!%5Bfeature(stdsimd)%5D%0A%23!%5Bcfg_attr(not(dox)%2C%20no_std)%5D%0A%23%5Bcfg(not(dox))%5D%0A%23%5Bmacro_use%5D%0Aextern%20crate%20std%20as%20real_std%3B%0A%23%5Bcfg(not(dox))%5D%0A%23%5Bmacro_use%5D%0Aextern%20crate%20stdsimd%20as%20std%3B%0A%23%5Bcfg(target_arch%20%3D%20%22x86%22)%5D%0Ause%20std%3A%3Aarch%3A%3Ax86%3A%3A*%3B%0A%23%5Bcfg(target_arch%20%3D%20%22x86_64%22)%5D%0Ause%20std%3A%3Aarch%3A%3Ax86_64%3A%3A*%3B%0A%0Afn%20main()%20%7B%0A%20%20%20%20if%20is_x86_feature_detected!(%22sse4.2%22)%20%7B%0A%20%20%20%20%20%20%20%20%23%5Btarget_feature(enable%20%3D%20%22sse4.2%22)%5D%0A%20%20%20%20%20%20%20%20unsafe%20fn%20worker()%20%7B%0Alet%20mut%20some_utf16_words%20%3D%20%5B0u16%3B%208%5D%3B%0Alet%20mut%20more_utf16_words%20%3D%20%5B0u16%3B%208%5D%3B%0A'%E2%9D%A4'.encode_utf16(%26mut%20some_utf16_words)%3B%0A'%F0%9D%95%8A'.encode_utf16(%26mut%20more_utf16_words)%3B%0A%2F%2F%20Load%20the%20input%0Alet%20a%20%3D%20_mm_loadu_si128(some_utf16_words.as_ptr()%20as%20*const%20_)%3B%0Alet%20b%20%3D%20_mm_loadu_si128(more_utf16_words.as_ptr()%20as%20*const%20_)%3B%0A%0A%2F%2F%20Specify%20_SIDD_UWORD_OPS%20to%20compare%20words%20instead%20of%20bytes%2C%20and%0A%2F%2F%20use%20_SIDD_CMP_EQUAL_EACH%20to%20compare%20the%20two%20strings.%0Alet%20idx%20%3D%20_mm_cmpistri(a%2C%20b%2C%20_SIDD_UWORD_OPS%20%7C%20_SIDD_CMP_EQUAL_EACH)%3B%0A%0Aif%20idx%20%3D%3D%200%20%7B%0A%20%20%20%20println!(%2216-bit%20unicode%20strings%20were%20equal!%22)%3B%0Apanic!(%22Strings%20should%20not%20be%20equal!%22)%0A%7D%20else%20%7B%0A%20%20%20%20println!(%2216-bit%20unicode%20strings%20were%20not%20equal!%22)%3B%0A%7D%0A%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%20%20unsafe%20%7B%20worker()%3B%20%7D%0A%20%20%20%20%7D%0A%7D&amp;version=nightly">Run</a></pre>
<p><a href="https://software.intel.com/sites/landingpage/IntrinsicsGuide/#text=_mm_cmpistri">Intel's documentation</a></p>
</div></section><section id="search" class="content hidden"></section><section class="footer"></section><aside id="help" class="hidden"><div><h1 class="hidden">Help</h1><div class="shortcuts"><h2>Keyboard Shortcuts</h2><dl><dt><kbd>?</kbd></dt><dd>Show this help dialog</dd><dt><kbd>S</kbd></dt><dd>Focus the search field</dd><dt><kbd>↑</kbd></dt><dd>Move up in search results</dd><dt><kbd>↓</kbd></dt><dd>Move down in search results</dd><dt><kbd>↹</kbd></dt><dd>Switch tab</dd><dt><kbd>&#9166;</kbd></dt><dd>Go to active search result</dd><dt><kbd>+</kbd></dt><dd>Expand all sections</dd><dt><kbd>-</kbd></dt><dd>Collapse all sections</dd></dl></div><div class="infos"><h2>Search Tricks</h2><p>Prefix searches with a type followed by a colon (e.g. <code>fn:</code>) to restrict the search to a given type.</p><p>Accepted types are: <code>fn</code>, <code>mod</code>, <code>struct</code>, <code>enum</code>, <code>trait</code>, <code>type</code>, <code>macro</code>, and <code>const</code>.</p><p>Search functions by type signature (e.g. <code>vec -> usize</code> or <code>* -> vec</code>)</p><p>Search multiple things at once by splitting your query with comma (e.g. <code>str,u8</code> or <code>String,struct:Vec,test</code>)</p></div></div></aside><script>window.rootPath = "../../../";window.currentCrate = "core";</script><script src="../../../aliases.js"></script><script src="../../../main.js"></script><script defer src="../../../search-index.js"></script></body></html>