Revision 999267 of SIMD.Bool16x8

<div>{{JSRef}} {{SeeCompatTable}}</div>

<p>The <strong><code>SIMD.Bool16x8</code></strong> data type is a 128-bit vector divided into 8 lanes storing boolean values.</p>

<h2 id="Syntax">Syntax</h2>

<pre class="syntaxbox">
SIMD.Bool16x8(s0, s1, s2, s3, s4, s5, s6, s7);</pre>

<h3 id="Parameters">Parameters</h3>

<dl>
 <dt><code>s[0-7]</code> {{optional_inline}}</dt>
 <dd>A boolean specifying the value of the lane. Defaults to <code>false</code>.</dd>
</dl>

<h2 id="Constructor_functions">Constructor functions</h2>

<p>In addition to the simple creator function, the SIMD API provides the following constructor functions.</p>

<dl>
 <dt>{{jsxref("SIMD.splat", "SIMD.Bool16x8.splat()")}}</dt>
 <dd>Creates an Bool6x8 with all lanes set to a given value.</dd>
</dl>

<div class="note">
<p><strong>Note:</strong> SIMD types don't work with <code>new</code>, as SIMD values are no "boxed" objects (comparable to <code>String(s)</code> vs. <code>new String(s)</code>, which creates a String object).</p>

<pre class="brush: js example-bad">
var v = new SIMD.Bool16x8(true,true,true,true,false,false,false,false); 
// TypeError: SIMD.Bool16x8 is not a constructor
var w = new SIMD.Bool16x8.splat(true); 
// TypeError: SIMD.Bool16x8.splat is not a constructor
</pre>

<p>Instead, you just write:</p>

<pre class="brush: js example-good">
var v = SIMD.Bool16x8(true,true,true,true,false,false,false,false);
var w = SIMD.Bool16x8.splat(true);
</pre>
</div>

<h2 id="Operations">Operations</h2>

<p>To actually do something with SIMD types, SIMD operations are needed that work on SIMD data types.</p>

<h3 id="Checking_SIMD_types">Checking SIMD types</h3>

<dl>
 <dt>{{jsxref("SIMD.check", "SIMD.Bool16x8.check()")}}</dt>
 <dd>Returns a new Bool16x8 if the parameter is a valid Bool16x8 data type. Throws a {{jsxref("TypeError")}} otherwise.</dd>
</dl>

<h3 id="Accessing_and_mutating_lanes">Accessing and mutating lanes</h3>

<dl>
 <dt>{{jsxref("SIMD.extractLane", "SIMD.Bool16x8.extractLane()")}}</dt>
 <dd>Returns the value of the given lane.</dd>
 <dt>{{jsxref("SIMD.replaceLane", "SIMD.Bool16x8.replaceLane()")}}</dt>
 <dd>Returns a new Bool16x8 with the given lane value replaced.</dd>
</dl>

<dl>
 <dt>
 <h3 id="Boolean_operations">Boolean operations</h3>
 </dt>
 <dt>{{jsxref("SIMD.allTrue", "SIMD.Bool16x8.allTrue()")}}</dt>
 <dd>Checks if all lanes hold a <code>true</code> value.</dd>
 <dt>{{jsxref("SIMD.anyTrue", "SIMD.Bool16x8.anyTrue()")}}</dt>
 <dd>Checks if any of the lanes hold a <code>true</code> value.</dd>
</dl>

<h3 id="Bitwise_logical_operations">Bitwise logical operations</h3>

<dl>
 <dt>{{jsxref("SIMD.and", "SIMD.Bool16x8.and()")}}</dt>
 <dd>Returns a new Bool16x8 with the logical AND of the lane values (<code>a &amp; b</code>).</dd>
 <dt>{{jsxref("SIMD.or", "SIMD.Bool16x8.or()")}}</dt>
 <dd>Returns a new&nbsp;Bool16x8 with the logical OR of the lane values (<code>a | b</code>).</dd>
 <dt>{{jsxref("SIMD.xor", "SIMD.Bool16x8.xor()")}}</dt>
 <dd>Returns a new&nbsp;Bool16x8 with the logical XOR of the lane values (<code>a ^ b</code>).</dd>
 <dt>{{jsxref("SIMD.not", "SIMD.Bool16x8.not()")}}</dt>
 <dd>Returns a new&nbsp;Bool16x8 with lane with the logical NOT of the lane values (<code>~a</code>).</dd>
</dl>

<h2 id="SIMD_prototype">SIMD prototype</h2>

<p>The following methods and properties are installed on the <code>SIMD.Bool16x8.prototype</code>.</p>

<dl>
 <dt><code>SIMD.Bool16x8.prototype.constructor</code></dt>
 <dd>Specifies the function that creates a SIMD object's prototype.</dd>
 <dt>{{jsxref("SIMD.toLocaleString", "SIMD.Bool16x8.prototype.toLocaleString()")}}</dt>
 <dd>Returns a localized string representing the SIMD type and its elements. Overrides the {{jsxref("Object.prototype.toLocaleString()")}} method.</dd>
 <dt>{{jsxref("SIMD.toString", "SIMD.Bool16x8.prototype.toString()")}}</dt>
 <dd>Returns a string representing the SIMD type and its elements. Overrides the {{jsxref("Object.prototype.toString()")}} method.</dd>
 <dt>{{jsxref("SIMD.valueOf", "SIMD.Bool16x8.prototype.valueOf()")}}</dt>
 <dd>Returns the primitive value of a SIMD object.</dd>
 <dt>{{jsxref("SIMD.toSource", "SIMD.Bool16x8.prototype.toSource()")}} {{non-standard_inline}}</dt>
 <dd>Returns a string representing the source code of the object. Overrides the {{jsxref("Object.prototype.toSource()")}} method.</dd>
</dl>

<h2 id="Examples">Examples</h2>

<h3 id="Constructing_a_Bool16x8">Constructing a Bool16x8</h3>

<pre class="brush: js">
SIMD.Bool16x8(true, true, true, true, false, false, false, false); 
// Bool16x8[true, true, true, true, false, false, false, false]

SIMD.Bool16x8(true, false);
// Bool16x8[true, false, false, false, false, false, false, false]

SIMD.Bool16x8();
// Bool16x8[false, false, false false, false, false, false, false]
</pre>

<h2 id="Specifications">Specifications</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
  <tr>
   <td>{{SpecName('SIMD', '#bool16x8', 'Bool16x8')}}</td>
   <td>{{Spec2('SIMD')}}</td>
   <td>Initial definition.</td>
  </tr>
 </tbody>
</table>

<h2 id="Browser_compatibility">Browser compatibility</h2>

<p>{{CompatibilityTable}}</p>

<div id="compat-desktop">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Chrome</th>
   <th>Firefox (Gecko)</th>
   <th>Internet Explorer</th>
   <th>Opera</th>
   <th>Safari</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNightly("firefox")}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
  </tr>
 </tbody>
</table>
</div>

<div id="compat-mobile">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Android</th>
   <th>Chrome for Android</th>
   <th>Firefox Mobile (Gecko)</th>
   <th>IE Mobile</th>
   <th>Opera Mobile</th>
   <th>Safari Mobile</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNightly("firefox")}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
  </tr>
 </tbody>
</table>
</div>

<h2 id="See_also">See also</h2>

<ul>
 <li>{{jsxref("SIMD")}}</li>
</ul>