diff options
Diffstat (limited to 'files/zh-cn/web/javascript/reference/global_objects/atomics')
13 files changed, 1283 insertions, 0 deletions
diff --git a/files/zh-cn/web/javascript/reference/global_objects/atomics/add/index.html b/files/zh-cn/web/javascript/reference/global_objects/atomics/add/index.html new file mode 100644 index 0000000000..256ddc4019 --- /dev/null +++ b/files/zh-cn/web/javascript/reference/global_objects/atomics/add/index.html @@ -0,0 +1,84 @@ +--- +title: Atomics.add() +slug: Web/JavaScript/Reference/Global_Objects/Atomics/add +tags: + - Atomics + - JavaScript + - Shared Memory + - 共享内存 + - 方法 +translation_of: Web/JavaScript/Reference/Global_Objects/Atomics/add +--- +<div>{{JSRef}}</div> + +<p><code><strong>Atomics</strong></code><strong><code>.add()</code></strong> 静态方法会将给定的值加到数组里的某个特定位置上，并返回该位置的旧值。此原子操作保证在写上修改的值之前不会发生其他写操作。</p> + +<div>{{EmbedInteractiveExample("pages/js/atomics-add.html")}}</div> + + + +<h2 id="语法">语法</h2> + +<pre class="syntaxbox">Atomics.add(typedArray, index, value) +</pre> + +<h3 id="参数">参数</h3> + +<dl> + <dt><code>typedArray</code></dt> + <dd>一个共享的整型 typed array。例如 {{jsxref("Int8Array")}}，{{jsxref("Uint8Array")}}，{{jsxref("Int16Array")}}，{{jsxref("Uint16Array")}}，{{jsxref("Int32Array")}}，或者 {{jsxref("Uint32Array")}}。</dd> + <dt><code>index</code></dt> + <dd><code>typedArray</code> 中的位置，该位置数值会被加总并更新。</dd> + <dt><code>value</code></dt> + <dd>增加的数字。</dd> +</dl> + +<h3 id="返回值">返回值</h3> + +<p>给定位置的旧值（<code>typedArray[index]）</code>。</p> + +<h3 id="错误">错误</h3> + +<ul> + <li>假如 <code>typedArray</code> 不是允许的整型之一，则抛出 {{jsxref("TypeError")}}。</li> + <li><code><font face="Open Sans, Arial, sans-serif">假如 </font>typedArray</code> 不是一个shared typed array类型，则抛出 {{jsxref("TypeError")}}。</li> + <li>如果 <code>index</code> 超出了 <code>typedArray 的边界，则抛出</code> {{jsxref("RangeError")}}。</li> +</ul> + +<h2 id="示例">示例</h2> + +<pre class="brush: js">var sab = new SharedArrayBuffer(1024); +var ta = new Uint8Array(sab); + +Atomics.add(ta, 0, 12); // returns 0, the old value +Atomics.load(ta, 0); // 12</pre> + +<h2 id="规范">规范</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('ESDraft', '#sec-atomics.add', 'Atomics.add')}}</td> + <td>{{Spec2('ESDraft')}}</td> + <td>Initial definition in ES2017.</td> + </tr> + </tbody> +</table> + +<h2 id="浏览器支持">浏览器支持</h2> + + + +<p>{{Compat("javascript.builtins.Atomics.add")}}</p> + +<h2 id="相关">相关</h2> + +<ul> + <li>{{jsxref("Atomics")}}</li> + <li>{{jsxref("Atomics.sub()")}}</li> +</ul> diff --git a/files/zh-cn/web/javascript/reference/global_objects/atomics/and/index.html b/files/zh-cn/web/javascript/reference/global_objects/atomics/and/index.html new file mode 100644 index 0000000000..87754093bc --- /dev/null +++ b/files/zh-cn/web/javascript/reference/global_objects/atomics/and/index.html @@ -0,0 +1,130 @@ +--- +title: Atomics.and() +slug: Web/JavaScript/Reference/Global_Objects/Atomics/and +tags: + - Atomics + - JavaScript + - 共享内存 + - 实验性 + - 方法 +translation_of: Web/JavaScript/Reference/Global_Objects/Atomics/and +--- +<div>{{JSRef}} {{SeeCompatTable}}</div> + +<p><code><strong>Atomics</strong></code><strong><code>.and()</code></strong> 静态方法会将给定的值与数组上的值进行按位与操作，并将结果赋值给数组，然后返回数组该位置上的旧值。此原子操作保证在写上修改的值之前不会发生其他写操作。</p> + +<div>{{EmbedInteractiveExample("pages/js/atomics-and.html")}}</div> + + + +<h2 id="语法">语法</h2> + +<pre class="syntaxbox">Atomics.and(typedArray, index, value) +</pre> + +<h3 id="参数">参数</h3> + +<dl> + <dt><code>typedArray</code></dt> + <dd>一个共享的整型 typed array。例如 {{jsxref("Int8Array")}}，{{jsxref("Uint8Array")}}，{{jsxref("Int16Array")}}，{{jsxref("Uint16Array")}}，{{jsxref("Int32Array")}}，或 {{jsxref("Uint32Array")}}。</dd> + <dt><code>index</code></dt> + <dd><code>按位与操作的 typedArray 的值在数组</code>上的索引。</dd> + <dt><code>value</code></dt> + <dd>给定的按位与操作的值。</dd> +</dl> + +<h3 id="返回值">返回值</h3> + +<p>给定位置的旧值（<code>typedArray[index]）。</code></p> + +<h3 id="错误">错误</h3> + +<ul> + <li>假如 <code>typedArray</code> 不是允许的整型之一，则抛出 {{jsxref("TypeError")}}。</li> + <li><code><font face="Open Sans, Arial, sans-serif">假如 </font>typedArray</code> 不是一个贡献的 typed array，则抛出 {{jsxref("TypeError")}}。</li> + <li>如果 <code>index</code> 超出了 <code>typedArray 的边界，则抛出</code> {{jsxref("RangeError")}}。</li> +</ul> + +<h2 id="描述">描述</h2> + +<p>假如 a 和 b 都是 1，那么按位与运算（ a & b）仅产生1。与操作的真值表为：</p> + +<table class="standard-table"> + <thead> + <tr> + <th><code>a</code></th> + <th><code>b</code></th> + <th><code>a & b</code></th> + </tr> + </thead> + <tbody> + <tr> + <td>0</td> + <td>0</td> + <td>0</td> + </tr> + <tr> + <td>0</td> + <td>1</td> + <td>0</td> + </tr> + <tr> + <td>1</td> + <td>0</td> + <td>0</td> + </tr> + <tr> + <td>1</td> + <td>1</td> + <td>1</td> + </tr> + </tbody> +</table> + +<p>比如，一个按位与如 <code>5 & 1</code> 的结果是 <code>0001，其十进制就是</code>1<code>。</code></p> + +<pre>5 0101 +1 0001 + ---- +1 0001</pre> + +<h2 id="示例">示例</h2> + +<pre class="brush: js">var sab = new SharedArrayBuffer(1024); +var ta = new Uint8Array(sab); +ta[0] = 5; + +Atomics.and(ta, 0, 1); // returns 0, the old value +Atomics.load(ta, 0); // 1 +</pre> + +<h2 id="规范">规范</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('Shared Memory', '#Atomics.and', 'Atomics.and')}}</td> + <td>{{Spec2('Shared Memory')}}</td> + <td>Initial definition.</td> + </tr> + </tbody> +</table> + +<h2 id="浏览器支持">浏览器支持</h2> + + + +<p>{{Compat("javascript.builtins.Atomics.and")}}</p> + +<h2 id="相关">相关</h2> + +<ul> + <li>{{jsxref("Atomics")}}</li> + <li>{{jsxref("Atomics.or()")}}</li> + <li>{{jsxref("Atomics.xor()")}}</li> +</ul> diff --git a/files/zh-cn/web/javascript/reference/global_objects/atomics/compareexchange/index.html b/files/zh-cn/web/javascript/reference/global_objects/atomics/compareexchange/index.html new file mode 100644 index 0000000000..1883180411 --- /dev/null +++ b/files/zh-cn/web/javascript/reference/global_objects/atomics/compareexchange/index.html @@ -0,0 +1,86 @@ +--- +title: Atomics.compareExchange() +slug: Web/JavaScript/Reference/Global_Objects/Atomics/compareExchange +tags: + - Atomics + - JavaScript + - 共享内存 + - 方法 +translation_of: Web/JavaScript/Reference/Global_Objects/Atomics/compareExchange +--- +<div>{{JSRef}} {{SeeCompatTable}}</div> + +<p><code><strong>Atomics</strong></code><strong><code>.compareExchange()</code></strong> 静态方法会在数组的值与期望值相等的时候，将给定的替换值替换掉数组上的值，然后返回旧值。此原子操作保证在写上修改的值之前不会发生其他写操作。</p> + +<div>{{EmbedInteractiveExample("pages/js/atomics-compareexchange.html")}}</div> + + + +<h2 id="语法">语法</h2> + +<pre class="syntaxbox">Atomics.compareExchange(typedArray, index, expectedValue, replacementValue) +</pre> + +<h3 id="参数">参数</h3> + +<dl> + <dt><code>typedArray</code></dt> + <dd>一个共享的整型 typed array。例如 {{jsxref("Int8Array")}}，{{jsxref("Uint8Array")}}，{{jsxref("Int16Array")}}，{{jsxref("Uint16Array")}}，{{jsxref("Int32Array")}}，或 {{jsxref("Uint32Array")}}。</dd> + <dt><code>index</code></dt> + <dd><code>typedArray</code> 的索引。</dd> + <dt><code>expectedValue</code></dt> + <dd>用于比较的值。</dd> + <dt>replacementValue</dt> + <dd>将要替换上的值。</dd> +</dl> + +<h3 id="返回值">返回值</h3> + +<p>给定位置的旧值(<code>typedArray[index]</code>).</p> + +<h3 id="错误">错误</h3> + +<ul> + <li>假如 <code>typedArray</code> 不是允许的整型之一，则抛出 {{jsxref("TypeError")}}。</li> + <li><code><font face="Open Sans, Arial, sans-serif">假如 </font>typedArray</code> 不是一个贡献的 typed array，则抛出 {{jsxref("TypeError")}}。</li> + <li>如果 <code>index</code> 超出了 <code>typedArray 的边界，则抛出</code> {{jsxref("RangeError")}}。</li> +</ul> + +<h2 id="示例">示例</h2> + +<pre class="brush: js">var sab = new SharedArrayBuffer(1024); +var ta = new Uint8Array(sab); +ta[0] = 7; + +Atomics.compareExchange(ta, 0, 7, 12); // returns 7, the old value +Atomics.load(ta, 0); // 12</pre> + +<h2 id="规范">规范</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('Shared Memory', '#Atomics.compareExchange', 'Atomics.compareExchange')}}</td> + <td>{{Spec2('Shared Memory')}}</td> + <td>Initial definition.</td> + </tr> + </tbody> +</table> + +<h2 id="浏览器支持">浏览器支持</h2> + + + +<p>{{Compat("javascript.builtins.Atomics.compareExchange")}}</p> + +<h2 id="相关">相关</h2> + +<ul> + <li>{{jsxref("Atomics")}}</li> + <li>{{jsxref("Atomics.exchange()")}}</li> +</ul> diff --git a/files/zh-cn/web/javascript/reference/global_objects/atomics/exchange/index.html b/files/zh-cn/web/javascript/reference/global_objects/atomics/exchange/index.html new file mode 100644 index 0000000000..4502bf8a52 --- /dev/null +++ b/files/zh-cn/web/javascript/reference/global_objects/atomics/exchange/index.html @@ -0,0 +1,85 @@ +--- +title: Atomics.exchange() +slug: Web/JavaScript/Reference/Global_Objects/Atomics/exchange +tags: + - Atmoics + - Experimental + - JavaScript + - Method + - 共享内存 + - 实验性 +translation_of: Web/JavaScript/Reference/Global_Objects/Atomics/exchange +--- +<div>{{JSRef}} {{SeeCompatTable}}</div> + +<p><code><strong>Atomics</strong></code><strong><code>.exchange()</code></strong> 静态方法会用给定的值替换掉数组上的值，然后返回数组的旧值。此原子操作保证在写上修改的值之前不会发生其他写操作。</p> + +<div>{{EmbedInteractiveExample("pages/js/atomics-exchange.html")}}</div> + + + +<h2 id="语法">语法</h2> + +<pre class="syntaxbox">Atomics.exchange(typedArray, index, value) +</pre> + +<h3 id="参数">参数</h3> + +<dl> + <dt><code>typedArray</code></dt> + <dd>一个共享的整型 typed array。例如 {{jsxref("Int8Array")}}，{{jsxref("Uint8Array")}}，{{jsxref("Int16Array")}}，{{jsxref("Uint16Array")}}，{{jsxref("Int32Array")}}，或 {{jsxref("Uint32Array")}}。</dd> + <dt><code>index</code></dt> + <dd>被替换的 <code>typedArray 值的索引。</code></dd> + <dt><code>value</code></dt> + <dd>去替换的值。</dd> +</dl> + +<h3 id="返回值">返回值</h3> + +<p>给定位置的旧值(<code>typedArray[index]</code>).</p> + +<h3 id="错误">错误</h3> + +<ul> + <li>假如 <code>typedArray</code> 不是允许的整型之一，则抛出 {{jsxref("TypeError")}}。</li> + <li><code><font face="Open Sans, Arial, sans-serif">假如 </font>typedArray</code> 不是一个贡献的 typed array，则抛出 {{jsxref("TypeError")}}。</li> + <li>如果 <code>index</code> 超出了 <code>typedArray 的边界，则抛出</code> {{jsxref("RangeError")}}。</li> +</ul> + +<h2 id="示例">示例</h2> + +<pre class="brush: js">var sab = new SharedArrayBuffer(1024); +var ta = new Uint8Array(sab); + +Atomics.exchange(ta, 0, 12); // returns 0, the old value +Atomics.load(ta, 0); // 12</pre> + +<h2 id="规范">规范</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('Shared Memory', '#Atomics.exchange', 'Atomics.exchange')}}</td> + <td>{{Spec2('Shared Memory')}}</td> + <td>Initial definition.</td> + </tr> + </tbody> +</table> + +<h2 id="浏览器支持">浏览器支持</h2> + + + +<p>{{Compat("javascript.builtins.Atomics.exchange")}}</p> + +<h2 id="相关">相关</h2> + +<ul> + <li>{{jsxref("Atomics")}}</li> + <li>{{jsxref("Atomics.compareExchange()")}}</li> +</ul> diff --git a/files/zh-cn/web/javascript/reference/global_objects/atomics/index.html b/files/zh-cn/web/javascript/reference/global_objects/atomics/index.html new file mode 100644 index 0000000000..4c80b3f868 --- /dev/null +++ b/files/zh-cn/web/javascript/reference/global_objects/atomics/index.html @@ -0,0 +1,151 @@ +--- +title: Atomics +slug: Web/JavaScript/Reference/Global_Objects/Atomics +tags: + - JavaScript +translation_of: Web/JavaScript/Reference/Global_Objects/Atomics +--- +<p>{{JSRef}}</p> + +<p><strong><code>Atomics</code></strong> 对象提供了一组静态方法对 {{jsxref("SharedArrayBuffer")}} 和 {{jsxref("ArrayBuffer")}} 对象进行原子操作。</p> + +<h2 id="描述">描述</h2> + +<p>这些原子操作属于 <code>Atomics</code> 模块。与一般的全局对象不同，<code>Atomics</code> 不是构造函数，因此不能使用 <a href="https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Operators/new">new</a> 操作符调用，也不能将其当作函数直接调用。<code>Atomics</code> 的所有属性和方法都是静态的（与 {{jsxref("Math")}} 对象一样）。</p> + +<h3 id="原子操作">原子操作</h3> + +<p>多个共享内存的线程能够同时读写同一位置上的数据。原子操作会确保正在读或写的数据的值是符合预期的，即下一个原子操作一定会在上一个原子操作结束后才会开始，其操作过程不会中断。</p> + +<h3 id="等待和通知">等待和通知</h3> + +<p><code>wait()</code> 和 <code>notify()</code> 方法采用的是 Linux 上的 futexes 模型（“快速用户空间互斥量”），可以让进程一直等待直到某个特定的条件为真，主要用于实现阻塞。</p> + +<h2 id="方法">方法</h2> + +<dl> + <dt><span style="display: none;"> </span></dt> + <dt>{{jsxref("Atomics.add()")}}</dt> + <dd>将指定位置上的数组元素与给定的值相加，并返回相加前该元素的值。</dd> + <dt><strong>{{jsxref("Atomics.and()")}}</strong></dt> + <dd>将指定位置上的数组元素与给定的值相与，并返回与操作前该元素的值。</dd> + <dt>{{jsxref("Atomics.compareExchange()")}}</dt> + <dd>如果数组中指定的元素与给定的值相等，则将其更新为新的值，并返回该元素原先的值。</dd> + <dt>{{jsxref("Atomics.exchange()")}}</dt> + <dd>将数组中指定的元素更新为给定的值，并返回该元素更新前的值。</dd> + <dt>{{jsxref("Atomics.isLockFree()", "Atomics.isLockFree(size)")}}</dt> + <dd>可以用来检测当前系统是否支持硬件级的原子操作。对于指定大小的数组，如果当前系统支持硬件级的原子操作，则返回 <code>true</code>；否则就意味着对于该数组，<code>Atomics</code> 对象中的各原子操作都只能用锁来实现。此函数面向的是技术专家。</dd> + <dt>{{jsxref("Atomics.load()")}}</dt> + <dd>返回数组中指定元素的值。</dd> + <dt>{{jsxref("Atomics.notify()")}}</dt> + <dd>唤醒等待队列中正在数组指定位置的元素上等待的线程。返回值为成功唤醒的线程数量。</dd> + <dt>{{jsxref("Atomics.or()")}}</dt> + <dd>将指定位置上的数组元素与给定的值相或，并返回或操作前该元素的值。</dd> + <dt>{{jsxref("Atomics.store()")}}</dt> + <dd>将数组中指定的元素设置为给定的值，并返回<strong>该值</strong>。</dd> + <dt>{{jsxref("Atomics.sub()")}}</dt> + <dd>将指定位置上的数组元素与给定的值相减，并返回相减前该元素的值。</dd> + <dt>{{jsxref("Atomics.wait()")}}</dt> + <dd>检测数组中某个指定位置上的值是否仍然是给定值，是则保持挂起直到被唤醒或超时。返回值为 "<code>ok</code>"、"<code>not-equal</code>" 或 "<code>time-out</code>"。调用时，如果当前线程不允许阻塞，则会抛出异常（大多数浏览器都不允许在主线程中调用 <code>wait()</code>）。</dd> + <dt>{{jsxref("Atomics.xor()")}}</dt> + <dd>将指定位置上的数组元素与给定的值相异或，并返回异或操作前该元素的值。</dd> +</dl> + +<h2 id="示例">示例</h2> + +<h3 id="使用_Atomics">使用 Atomics</h3> + +<pre class="brush: js notranslate">const sab = new SharedArrayBuffer(1024); +const ta = new Uint8Array(sab); + +ta[0]; +// 0 + +ta[0] = 5; +// 5 + +Atomics.add(ta, 0, 12); +// 5 +Atomics.load(ta, 0); +// 17 ✅ +// 12 ❌ + +Atomics.and(ta, 0, 1); +// 17 +Atomics.load(ta, 0); +// 1 + +Atomics.compareExchange(ta, 0, 5, 12); +Atomics.load(ta, 0); // 12 + +Atomics.exchange(ta, 0, 12); +Atomics.load(ta, 0); // 12 + +Atomics.isLockFree(1); // true +Atomics.isLockFree(2); // true +Atomics.isLockFree(3); // false +Atomics.isLockFree(4); // true + +Atomics.or(ta, 0, 1); +Atomics.load(ta, 0); // 5 + +Atomics.store(ta, 0, 12); // 12 + +Atomics.sub(ta, 0, 2); +Atomics.load(ta, 0); // 3 + +Atomics.xor(ta, 0, 1); +Atomics.load(ta, 0); // 4 +</pre> + +<h3 id="Waiting_和_notifiying">Waiting 和 notifiying</h3> + +<p>给定一个共享的 <code>Int32Array</code>：</p> + +<pre class="brush: js notranslate">const sab = new SharedArrayBuffer(1024); +const int32 = new Int32Array(sab); +</pre> + +<p>读取线程正在休眠并位置0上等待。只要该位置应为0，它就不会继续。但是，一旦写入线程存储了新值，写入线程将通知它并返回新值（123）。</p> + +<pre class="brush: js notranslate">Atomics.wait(int32, 0, 0); +console.log(int32[0]); // 123 +</pre> + +<p>写入线程存储一个新值并再写入完成时通知等待线程：</p> + +<pre class="brush: js notranslate">console.log(int32[0]); // 0; +Atomics.store(int32, 0, 123); +Atomics.notify(int32, 0, 1);</pre> + +<h2 id="规范">规范</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">Specification</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-atomics-object', 'Atomics')}}</td> + </tr> + </tbody> +</table> + +<h2 id="浏览器兼容性">浏览器兼容性</h2> + +<div class="hidden">The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> and send us a pull request.</div> + +<p>{{Compat("javascript.builtins.Atomics")}}</p> + +<h2 id="相关链接">相关链接</h2> + +<ul> + <li>{{jsxref("ArrayBuffer")}}</li> + <li><a href="/zh-CN/docs/Web/JavaScript/Typed_arrays">JavaScript typed arrays</a></li> + <li><a href="/zh-CN/docs/Web/API/Web_Workers_API">Web Workers</a></li> + <li><a href="https://github.com/lars-t-hansen/parlib-simple">parlib-simple </a>– a simple library providing synchronization and work distribution abstractions.</li> + <li><a href="https://github.com/tc39/ecmascript_sharedmem/blob/master/TUTORIAL.md">Shared Memory – a brief tutorial</a></li> + <li><a href="https://hacks.mozilla.org/2016/05/a-taste-of-javascripts-new-parallel-primitives/">A Taste of JavaScript’s New Parallel Primitives – Mozilla Hacks</a></li> +</ul> diff --git a/files/zh-cn/web/javascript/reference/global_objects/atomics/islockfree/index.html b/files/zh-cn/web/javascript/reference/global_objects/atomics/islockfree/index.html new file mode 100644 index 0000000000..be8b32b587 --- /dev/null +++ b/files/zh-cn/web/javascript/reference/global_objects/atomics/islockfree/index.html @@ -0,0 +1,69 @@ +--- +title: Atomics.isLockFree() +slug: Web/JavaScript/Reference/Global_Objects/Atomics/isLockFree +translation_of: Web/JavaScript/Reference/Global_Objects/Atomics/isLockFree +--- +<div>{{JSRef}} {{SeeCompatTable}}</div> + +<p>静态方法 <code><strong>Atomics</strong></code><strong><code>.isLockFree()</code></strong> 用于校验是否能够使用原子操作的<code><a href="https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/TypedArray/BYTES_PER_ELEMENT" title="TypedArray.BYTES_PER_ELEMENT 属性代表了强类型数组中每个元素所占用的字节数。">TypedArray</a></code>的标准字节长度之一. 若该字节长度为可处理的TypedArray标准字节长度之一则返回 <code>true.</code> TypedArray的标准字节长度参见 <a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray/BYTES_PER_ELEMENT">BYTES_PER_ELEMENT</a></p> + +<div>{{EmbedInteractiveExample("pages/js/atomics-islockfree.html")}}</div> + + + +<h2 id="语法">语法</h2> + +<pre class="syntaxbox">Atomics.isLockFree(size) +</pre> + +<h3 id="参数">参数</h3> + +<dl> + <dt><code>size</code></dt> + <dd>整形.字节长度,通常为<a href="https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/TypedArray/BYTES_PER_ELEMENT" title="TypedArray.BYTES_PER_ELEMENT 属性代表了强类型数组中每个元素所占用的字节数。"><code>TypedArray.BYTES_PER_ELEMENT</code></a></dd> +</dl> + +<h3 id="返回值">返回值</h3> + +<p> {{jsxref("Boolean")}} 是否为能够使用原子操作的<code><a href="https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/TypedArray/BYTES_PER_ELEMENT" title="TypedArray.BYTES_PER_ELEMENT 属性代表了强类型数组中每个元素所占用的字节数。">TypedArray</a></code>的标准字节长度之一.</p> + +<h2 id="示例">示例</h2> + +<pre class="brush: js">Atomics.isLockFree(1); // true +Atomics.isLockFree(2); // true +Atomics.isLockFree(3); // false +Atomics.isLockFree(4); // true +Atomics.isLockFree(5); // false +Atomics.isLockFree(6); // false +Atomics.isLockFree(7); // false +Atomics.isLockFree(8); // false +Atomics.isLockFree(<code>Float64Array.BYTES_PER_ELEMENT</code>); // false,<code>Atomics方法无法处理Float64Array</code></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('Shared Memory', '#Atomics.isLockFree', 'Atomics.isLockFree')}}</td> + <td>{{Spec2('Shared Memory')}}</td> + <td>Initial definition.</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility">Browser compatibility</h2> + + + +<p>{{Compat("javascript.builtins.Atomics.isLockFree")}}</p> + +<h2 id="See_also">See also</h2> + +<ul> + <li>{{jsxref("Atomics")}}</li> +</ul> diff --git a/files/zh-cn/web/javascript/reference/global_objects/atomics/load/index.html b/files/zh-cn/web/javascript/reference/global_objects/atomics/load/index.html new file mode 100644 index 0000000000..2129a3a4ab --- /dev/null +++ b/files/zh-cn/web/javascript/reference/global_objects/atomics/load/index.html @@ -0,0 +1,76 @@ +--- +title: Atomics.load() +slug: Web/JavaScript/Reference/Global_Objects/Atomics/load +translation_of: Web/JavaScript/Reference/Global_Objects/Atomics/load +--- +<div>{{JSRef}}</div> + +<p>静态方法 <code><strong>Atomics</strong></code><strong><code>.load()</code></strong> 返回一个数组当中给定位置的值。</p> + +<div>{{EmbedInteractiveExample("pages/js/atomics-load.html")}}</div> + + + +<h2 id="语法">语法</h2> + +<pre class="syntaxbox">Atomics.load(typedArray, index) +</pre> + +<h3 id="参数">参数</h3> + +<dl> + <dt><code>typedArray</code></dt> + <dd>一个共享的整型数组。可以是 {{jsxref("Int8Array")}}，{{jsxref("Uint8Array")}}，{{jsxref("Int16Array")}}，{{jsxref("Uint16Array")}}，{{jsxref("Int32Array")}} 或 {{jsxref("Uint32Array")}}.</dd> + <dt><code>index</code></dt> + <dd>在 <code>typedArray</code> 中需要加载的位置<font face="consolas, Liberation Mono, courier, monospace"><span style="background-color: rgba(220, 220, 220, 0.5);">。</span></font></dd> +</dl> + +<h3 id="返回值">返回值</h3> + +<p>给定位置的值 (<code>typedArray[index]</code>)。</p> + +<h3 id="异常">异常</h3> + +<ul> + <li>抛出 {{jsxref("TypeError")}}, 如果 <code>typedArray</code> 不是一个被允许的整型。</li> + <li>抛出 {{jsxref("TypeError")}}, 如果 <code>typedArray</code> 不是一个共享数组。</li> + <li>抛出 {{jsxref("RangeError")}}, 如果 <code>index</code> 超出 <code>typedArray</code> 的界限。</li> +</ul> + +<h2 id="示例">示例</h2> + +<pre class="brush: js">var sab = new SharedArrayBuffer(1024); +var ta = new Uint8Array(sab); + +Atomics.add(ta, 0, 12); +Atomics.load(ta, 0); // 12</pre> + +<h2 id="规范">规范</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">规范</th> + <th scope="col">状态</th> + <th scope="col">论述</th> + </tr> + <tr> + <td>{{SpecName('ESDraft', '#sec-atomics.load', 'Atomics.load')}}</td> + <td>{{Spec2('ESDraft')}}</td> + <td>Initial definition in ES2017.</td> + </tr> + </tbody> +</table> + +<h2 id="浏览器兼容">浏览器兼容</h2> + +<div class="hidden">本页的兼容性表格是通过数据生成的。 如果你愿意对这些数据做些贡献，请检出 <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> 然后给我们发一个 pull request。</div> + +<p>{{Compat("javascript.builtins.Atomics.load")}}</p> + +<h2 id="参阅">参阅</h2> + +<ul> + <li>{{jsxref("Atomics")}}</li> + <li>{{jsxref("Atomics.store()")}}</li> +</ul> diff --git a/files/zh-cn/web/javascript/reference/global_objects/atomics/notify/index.html b/files/zh-cn/web/javascript/reference/global_objects/atomics/notify/index.html new file mode 100644 index 0000000000..bf2399192c --- /dev/null +++ b/files/zh-cn/web/javascript/reference/global_objects/atomics/notify/index.html @@ -0,0 +1,93 @@ +--- +title: Atomics.notify() +slug: Web/JavaScript/Reference/Global_Objects/Atomics/notify +tags: + - Atomics + - JavaScript + - Method + - Shared Memory +translation_of: Web/JavaScript/Reference/Global_Objects/Atomics/notify +--- +<div>{{JSRef}}</div> + +<p>静态方法 <code><strong>Atomics</strong></code><strong><code>.notify()</code></strong> 提醒一些在等待队列中休眠的代理。</p> + +<div class="note"> +<p><strong>注意：</strong>本操作仅在共享的 {{jsxref("Int32Array")}} 下可用。</p> +</div> + +<h2 id="语法">语法</h2> + +<pre class="syntaxbox notranslate">Atomics.notify(typedArray, index, count) +</pre> + +<h3 id="参数">参数</h3> + +<dl> + <dt><code>typedArray</code></dt> + <dd>一个共享的 {{jsxref("Int32Array")}}。</dd> + <dt><code>index</code></dt> + <dd><code>typedArray</code> 中要唤醒的目标索引。</dd> + <dt><code>count</code></dt> + <dd>要通知的正在休眠的代理的数量。默认是 {{jsxref("Infinity", "+Infinity")}}。</dd> +</dl> + +<h3 id="返回值">返回值</h3> + +<p>被唤醒的代理的数量。</p> + +<h3 id="异常">异常</h3> + +<ul> + <li>若 <code>typedArray</code> 不是共享的 {{jsxref("Int32Array")}}，则抛出一个 {{jsxref("TypeError")}} 异常。</li> + <li>若 <code>index</code> 索引超出了 <code>typedArray</code> 的大小，则抛出一个 {{jsxref("RangeError")}} 异常。</li> +</ul> + +<h2 id="示例">示例</h2> + +<p>分配一个共享的 <code>Int32Array</code>：</p> + +<pre class="brush: js notranslate">var sab = new SharedArrayBuffer(1024); +var int32 = new Int32Array(sab); +</pre> + +<p>一个读线程会进入休眠并监视索引0处的值（默认为0）。只要索引0处的值不为0，读进程就会唤醒。但是，一旦写进程存储了一个新的值，写进程就会产生一个提醒并返回写入后的新值（123）。（这里示例有问题或者说对初学者不友好，如果直接在浏览器控制台运行下面代码会报错，因为我们不能尝试睡眠主线程，可以见 <a href="https://github.com/lizhongzhen11/lizz-blog/issues/125#notice">重学js —— 结构化数据之Atomics对象</a>，同时我在 <strong>codepen </strong>写了一个示例：<a href="https://codepen.io/lizhongzhen11/project/editor/AmzyaY#">Atomics.wait使用示例</a>）</p> + +<pre class="brush: js notranslate">Atomics.wait(int32, 0, 0); +console.log(int32[0]); // 123</pre> + +<p>写进程写入一个新值并告知等待进程已经写入成功了：</p> + +<pre class="brush: js notranslate">console.log(int32[0]); // 0; +Atomics.store(int32, 0, 123); +Atomics.notify(int32, 0, 1);</pre> + +<h2 id="规范">规范</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">规范</th> + <th scope="col">状态</th> + <th scope="col">注释</th> + </tr> + <tr> + <td>{{SpecName('ESDraft', '#sec-atomics.notify', 'Atomics.notify')}}</td> + <td>{{Spec2('ESDraft')}}</td> + <td>Initial definition in ES2017.</td> + </tr> + </tbody> +</table> + +<h2 id="浏览器兼容性">浏览器兼容性</h2> + + + +<p>{{Compat("javascript.builtins.Atomics.notify")}}</p> + +<h2 id="相关文档">相关文档</h2> + +<ul> + <li>{{jsxref("Atomics")}}</li> + <li>{{jsxref("Atomics.wait()")}}</li> +</ul> diff --git a/files/zh-cn/web/javascript/reference/global_objects/atomics/or/index.html b/files/zh-cn/web/javascript/reference/global_objects/atomics/or/index.html new file mode 100644 index 0000000000..286e89cc0a --- /dev/null +++ b/files/zh-cn/web/javascript/reference/global_objects/atomics/or/index.html @@ -0,0 +1,129 @@ +--- +title: Atomics.or() +slug: Web/JavaScript/Reference/Global_Objects/Atomics/or +tags: + - Atomics + - JavaScript + - Method + - Shared Memory +translation_of: Web/JavaScript/Reference/Global_Objects/Atomics/or +--- +<div>{{JSRef}}</div> + +<p>静态方法 <code><strong>Atomics</strong></code><strong><code>.or()</code></strong> 用数组中指定位置的值进行一次按位或运算，并返回未计算时数组中指定位置处的值。这个atomic操作保证了在修改后的值被写回之前没有其它的写入操作发生。</p> + +<div>{{EmbedInteractiveExample("pages/js/atomics-or.html")}}</div> + + + +<h2 id="Syntax">Syntax</h2> + +<pre class="syntaxbox">Atomics.or(typedArray, index, value) +</pre> + +<h3 id="参数">参数</h3> + +<dl> + <dt><code>typedArray</code></dt> + <dd>一个共享的int数组，类型为 {{jsxref("Int8Array")}}、{{jsxref("Uint8Array")}}、{{jsxref("Int16Array")}}、{{jsxref("Uint16Array")}}、{{jsxref("Int32Array")}} 或 {{jsxref("Uint32Array")}}。</dd> + <dt><code>index</code></dt> + <dd><code>typedArray</code> 中要进行按位或运算的索引。</dd> + <dt><code>value</code></dt> + <dd>要进行按位或运算的数。</dd> +</dl> + +<h3 id="返回值">返回值</h3> + +<p><code>typedArray[index]</code> 处运算前的值。</p> + +<h3 id="异常">异常</h3> + +<ul> + <li>若 <code>typedArray</code> 不是一个可用的int类型，则抛出一个 {{jsxref("TypeError")}} 异常。</li> + <li>若 <code>typedArray</code> 不是一个共享的数组类型，则抛出一个 {{jsxref("TypeError")}} 异常。</li> + <li>若 <code>index</code> 索引超出了 <code>typedArray</code> 的大小，则抛出一个 {{jsxref("RangeError")}} 异常。</li> +</ul> + +<h2 id="详情">详情</h2> + +<p>当 <code>a</code> 或者 <code>b</code> 为1时，按位或运算结果为1。或运算真值表如下：</p> + +<table class="standard-table"> + <thead> + <tr> + <th><code>a</code></th> + <th><code>b</code></th> + <th><code>a | b</code></th> + </tr> + </thead> + <tbody> + <tr> + <td>0</td> + <td>0</td> + <td>0</td> + </tr> + <tr> + <td>0</td> + <td>1</td> + <td>1</td> + </tr> + <tr> + <td>1</td> + <td>0</td> + <td>1</td> + </tr> + <tr> + <td>1</td> + <td>1</td> + <td>1</td> + </tr> + </tbody> +</table> + +<p>例如，让 <code>5 & 1</code> 进行按位或运算的结果是 <code>0101</code> ，也就是十进制的5：</p> + +<pre>5 0101 +1 0001 + ---- +5 0101 +</pre> + +<h2 id="示例">示例</h2> + +<pre class="brush: js">var sab = new SharedArrayBuffer(1024); +var ta = new Uint8Array(sab); +ta[0] = 2; + +Atomics.or(ta, 0, 1); // returns 2, the old value +Atomics.load(ta, 0); // 3</pre> + +<h2 id="规范">规范</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">规范</th> + <th scope="col">状态</th> + <th scope="col">注释</th> + </tr> + <tr> + <td>{{SpecName('ESDraft', '#sec-atomics.or', 'Atomics.or')}}</td> + <td>{{Spec2('ESDraft')}}</td> + <td>Initial definition in ES2017.</td> + </tr> + </tbody> +</table> + +<h2 id="浏览器兼容性">浏览器兼容性</h2> + + + +<p>{{Compat("javascript.builtins.Atomics.or")}}</p> + +<h2 id="相关文档">相关文档</h2> + +<ul> + <li>{{jsxref("Atomics")}}</li> + <li>{{jsxref("Atomics.and()")}}</li> + <li>{{jsxref("Atomics.xor()")}}</li> +</ul> diff --git a/files/zh-cn/web/javascript/reference/global_objects/atomics/store/index.html b/files/zh-cn/web/javascript/reference/global_objects/atomics/store/index.html new file mode 100644 index 0000000000..bfc5a03982 --- /dev/null +++ b/files/zh-cn/web/javascript/reference/global_objects/atomics/store/index.html @@ -0,0 +1,77 @@ +--- +title: Atomics.store() +slug: Web/JavaScript/Reference/Global_Objects/Atomics/store +translation_of: Web/JavaScript/Reference/Global_Objects/Atomics/store +--- +<div>{{JSRef}}</div> + +<p>静态的Atomics.store（）方法将给定的值存储在数组中的指定位置，并返回该值。.</p> + +<div>{{EmbedInteractiveExample("pages/js/atomics-store.html")}}</div> + + + +<h2 id="语法">语法</h2> + +<pre class="syntaxbox">Atomics.store(typedArray, index, value) +</pre> + +<h3 id="参数">参数</h3> + +<dl> + <dt><code>typedArray</code></dt> + <dd>一个指定类型的shared数组. 类型为 {{jsxref("Int8Array")}}, {{jsxref("Uint8Array")}}, {{jsxref("Int16Array")}}, {{jsxref("Uint16Array")}}, {{jsxref("Int32Array")}}, 或者 {{jsxref("Uint32Array")}}其中一个.</dd> + <dt><code>index</code></dt> + <dd>typedArray中用来存储value的位置.</dd> + <dt><code>value</code></dt> + <dd>要存储的数字.</dd> +</dl> + +<h3 id="返回值">返回值</h3> + +<p>被存储的值.</p> + +<h3 id="异常">异常</h3> + +<ul> + <li>抛出一个{{jsxref("TypeError")}}异常, 如果 <code>typedArray</code> 不是上述给定的类型之一.</li> + <li>抛出一个{{jsxref("TypeError")}}异常, 如果 <code>typedArray</code> 不是一个指定类型的shared类型数组.</li> + <li>抛出一个{{jsxref("RangeError")}}异常, 如果 <code>index</code> 在 <code>typedArray</code>中越界了。</li> +</ul> + +<h2 id="示例">示例</h2> + +<pre class="brush: js">var sab = new SharedArrayBuffer(1024); +var ta = new Uint8Array(sab); + +Atomics.store(ta, 0, 12); // 12</pre> + +<h2 id="规范">规范</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('ESDraft', '#sec-atomics.store', 'Atomics.store')}}</td> + <td>{{Spec2('ESDraft')}}</td> + <td>Initial definition in ES2017.</td> + </tr> + </tbody> +</table> + +<h2 id="浏览器兼容性">浏览器兼容性</h2> + +<div class="hidden">此页面上的兼容性表格由结构化数据生成。 如果您想为数据做出贡献，请查看 <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> 并向我们发送 pr（pull request）请求。</div> + +<p>{{Compat("javascript.builtins.Atomics.store")}}</p> + +<h2 id="相关链接">相关链接</h2> + +<ul> + <li>{{jsxref("Atomics")}}</li> + <li>{{jsxref("Atomics.load()")}}</li> +</ul> diff --git a/files/zh-cn/web/javascript/reference/global_objects/atomics/sub/index.html b/files/zh-cn/web/javascript/reference/global_objects/atomics/sub/index.html new file mode 100644 index 0000000000..c5a43d3e35 --- /dev/null +++ b/files/zh-cn/web/javascript/reference/global_objects/atomics/sub/index.html @@ -0,0 +1,82 @@ +--- +title: Atomics.sub() +slug: Web/JavaScript/Reference/Global_Objects/Atomics/sub +translation_of: Web/JavaScript/Reference/Global_Objects/Atomics/sub +--- +<div>{{JSRef}}</div> + +<div><code><strong>Atomics.sub()</strong></code> 静态方法在数组中的给定位置减去给定值，并返回该位置的旧值。这个原子操作保证在修改后的值被写回之前不会发生其他写操作。</div> + +<div></div> + +<div>{{EmbedInteractiveExample("pages/js/atomics-sub.html")}}</div> + + + +<h2 id="语法">语法</h2> + +<pre class="syntaxbox">Atomics.sub(typedArray, index, value) +</pre> + +<h3 id="参数">参数</h3> + +<dl> + <dt><code>typedArray</code></dt> + <dd>一个共享的整型 typed array。 例如 {{jsxref("Int8Array")}}, {{jsxref("Uint8Array")}}, {{jsxref("Int16Array")}}, {{jsxref("Uint16Array")}}, {{jsxref("Int32Array")}}, 或者 {{jsxref("Uint32Array")}}.</dd> + <dt><code>index</code></dt> + <dd>要被 <code>value</code> 值减去的 <code>typedArray</code> 索引位置。</dd> + <dt><code>value</code></dt> + <dd>要减去的数字。</dd> +</dl> + +<h3 id="返回值">返回值</h3> + +<p>给定位置的旧值 (<code>typedArray[index]</code>)。</p> + +<h3 id="异常">异常</h3> + +<ul> + <li>假如 <code>typedArray</code> 不是允许的整型之一，则抛出 {{jsxref("TypeError")}}。</li> + <li>假如 <code>typedArray</code> 不是一个共享的整型 typed array，则抛出 {{jsxref("TypeError")}}。</li> + <li>如果 <code>index</code> 超出了 <code>typedArray</code> 的边界，则抛出 {{jsxref("RangeError")}}。</li> +</ul> + +<h2 id="例子">例子</h2> + +<pre class="brush: js">const sab = new SharedArrayBuffer(1024); +const ta = new Uint8Array(sab); +ta[0] = 48; + +Atomics.sub(ta, 0, 12); // returns 48, the old value +Atomics.load(ta, 0); // 36 +</pre> + +<h2 id="规范">规范</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('ESDraft', '#sec-atomics.sub', 'Atomics.sub')}}</td> + <td>{{Spec2('ESDraft')}}</td> + <td>Initial definition in ES2017.</td> + </tr> + </tbody> +</table> + +<h2 id="浏览器支持">浏览器支持</h2> + + + +<p>{{Compat("javascript.builtins.Atomics.sub")}}</p> + +<h2 id="相关">相关</h2> + +<ul> + <li>{{jsxref("Atomics")}}</li> + <li>{{jsxref("Atomics.add()")}}</li> +</ul> diff --git a/files/zh-cn/web/javascript/reference/global_objects/atomics/wait/index.html b/files/zh-cn/web/javascript/reference/global_objects/atomics/wait/index.html new file mode 100644 index 0000000000..6a14b9260a --- /dev/null +++ b/files/zh-cn/web/javascript/reference/global_objects/atomics/wait/index.html @@ -0,0 +1,95 @@ +--- +title: Atomics.wait() +slug: Web/JavaScript/Reference/Global_Objects/Atomics/wait +tags: + - Atomics + - JavaScript + - Method + - Shared Memory +translation_of: Web/JavaScript/Reference/Global_Objects/Atomics/wait +--- +<div>{{JSRef}}</div> + +<p>静态方法 <code><strong>Atomics</strong></code><strong><code>.wait()</code></strong> 确保了一个在 {{jsxref("Int32Array")}} 数组中给定位置的值没有发生变化、仍然是给定的值时进程将会睡眠，直到被唤醒或超时。该方法返回一个字符串，值为<code>"ok"</code>, <code>"not-equal"</code>, 或 <code>"timed-out"</code> 之一。</p> + +<div class="note"> +<p><strong>注意:</strong> 这项操作仅允许同一个共享内存的 {{jsxref("Int32Array")}} 配合使用并且无法运行在主线程中。</p> +</div> + +<h2 id="语法">语法</h2> + +<pre class="syntaxbox">Atomics.wait(typedArray, index, value[, timeout]) +</pre> + +<h3 id="参数">参数</h3> + +<dl> + <dt><code>typedArray</code></dt> + <dd>一个共享内存的 {{jsxref("Int32Array")}} 数组。</dd> + <dt><code>index</code></dt> + <dd>给定需要检测的 <code>typedArray</code> 数组的位置索引。</dd> + <dt><code>value</code></dt> + <dd>给定需要检测的位置索引的预期值。</dd> + <dt><code>timeout</code> {{optional_inline}}</dt> + <dd>超时前等待的毫秒数。 {{jsxref("Infinity")}}, 如未提供该参数，将为无穷大。</dd> +</dl> + +<h3 id="返回值">返回值</h3> + +<p>一个 {{jsxref("String")}} 字符串，值为 "<code>ok</code>", "<code>not-equal</code>", 或 "<code>timed-out</code>" 三种之一。</p> + +<h3 id="异常">异常</h3> + +<ul> + <li>如果参数 <code>typedArray</code> 不是一个共享内存的 {{jsxref("Int32Array")}} 数组，将会抛出一个 {{jsxref("TypeError")}} 。</li> + <li>如果参数 <code>index</code> 超出了参数 <code>typedArray</code>的边界，将会抛出一个 {{jsxref("RangeError")}} 。</li> +</ul> + +<h2 id="示例">示例</h2> + +<p>创建一个共享内存的 <code>Int32Array</code> :</p> + +<pre class="brush: js">var sab = new SharedArrayBuffer(1024); +var int32 = new Int32Array(sab); +</pre> + +<p>检测给定的数组索引0的值，如果它如预期一般的等于我们给定的值0，则这个读取线程将会睡眠等待。一旦当有一个写入线程在这个位置存储了一个新值，它将会收到写入线程的通知并且返回新值 (123) :</p> + +<pre class="brush: js">Atomics.wait(int32, 0, 0); +console.log(int32[0]); // 123</pre> + +<p>一旦某个写入线程存储了一个新值到<code>int32</code> 的索引0位置，则通知给该等待线程：</p> + +<pre class="brush: js">console.log(int32[0]); // 0; +Atomics.store(int32, 0, 123); +Atomics.notify(int32, 0, 1);</pre> + +<h2 id="规范">规范</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">规范</th> + <th scope="col">状态</th> + <th scope="col">备注</th> + </tr> + <tr> + <td>{{SpecName('ESDraft', '#sec-atomics.wait', 'Atomics.wait')}}</td> + <td>{{Spec2('ESDraft')}}</td> + <td>Initial definition in ES2017.</td> + </tr> + </tbody> +</table> + +<h2 id="浏览器支持">浏览器支持</h2> + +<div class="hidden">本页的支持列表生成自结构化的数据。如果你希望为这个数据做出贡献， 请检出 <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> 并发送一个拉取请求给我们。</div> + +<p>{{Compat("javascript.builtins.Atomics.wait")}}</p> + +<h2 id="相关参阅">相关参阅</h2> + +<ul> + <li>{{jsxref("Atomics")}}</li> + <li>{{jsxref("Atomics.notify()")}}</li> +</ul> diff --git a/files/zh-cn/web/javascript/reference/global_objects/atomics/xor/index.html b/files/zh-cn/web/javascript/reference/global_objects/atomics/xor/index.html new file mode 100644 index 0000000000..83b0bdfb46 --- /dev/null +++ b/files/zh-cn/web/javascript/reference/global_objects/atomics/xor/index.html @@ -0,0 +1,126 @@ +--- +title: Atomics.xor() +slug: Web/JavaScript/Reference/Global_Objects/Atomics/xor +translation_of: Web/JavaScript/Reference/Global_Objects/Atomics/xor +--- +<div>{{JSRef}}</div> + +<div><code><strong>Atomics</strong></code><strong><code>.xor()</code></strong> 静态方法会在数组中给定位置进行一次按位异或操作，并返回该位置的旧值。这个原子操作保证在修改后的值被写回之前不会发生其他写操作。</div> + +<div></div> + +<div>{{EmbedInteractiveExample("pages/js/atomics-xor.html")}}</div> + + + +<h2 id="语法">语法</h2> + +<pre class="syntaxbox">Atomics.xor(typedArray, index, value) +</pre> + +<h3 id="参数">参数</h3> + +<dl> + <dt><code>typedArray</code></dt> + <dd>一个共享的整型 typed array。例如 {{jsxref("Int8Array")}}, {{jsxref("Uint8Array")}}, {{jsxref("Int16Array")}}, {{jsxref("Uint16Array")}}, {{jsxref("Int32Array")}}, 或者 {{jsxref("Uint32Array")}}.</dd> + <dt><code>index</code></dt> + <dd><code>typedArray</code> 中需要进行按位异或的索引位置。</dd> + <dt><code>value</code></dt> + <dd>要进行按位异或的数字。</dd> +</dl> + +<h3 id="返回值">返回值</h3> + +<p>给定位置的旧值 (<code>typedArray[index]</code>)。</p> + +<h3 id="异常">异常</h3> + +<ul> + <li>假如 <code>typedArray</code> 不是允许的整型之一，则抛出 {{jsxref("TypeError")}}。</li> + <li>假如 <code>typedArray</code> 不是一个共享的整型 typed array，则抛出 {{jsxref("TypeError")}}。</li> + <li>如果 <code>index</code> 超出了 <code>typedArray</code> 的边界，则抛出 {{jsxref("RangeError")}}。</li> +</ul> + +<h2 id="描述">描述</h2> + +<p>如果a和b不同，则按位异或操作产生1。异或操作的真值表如下：</p> + +<table class="standard-table"> + <thead> + <tr> + <th><code>a</code></th> + <th><code>b</code></th> + <th><code>a ^ b</code></th> + </tr> + </thead> + <tbody> + <tr> + <td>0</td> + <td>0</td> + <td>0</td> + </tr> + <tr> + <td>0</td> + <td>1</td> + <td>1</td> + </tr> + <tr> + <td>1</td> + <td>0</td> + <td>1</td> + </tr> + <tr> + <td>1</td> + <td>1</td> + <td>0</td> + </tr> + </tbody> +</table> + +<p>例如，按位异或 <code>5 & 1</code> 将返回 <code>0100</code>，而 <code>0100</code> 是十进制为 <code>4</code> 。</p> + +<pre>5 0101 +1 0001 + ---- +4 0100 +</pre> + +<h2 id="例子">例子</h2> + +<pre class="brush: js">const sab = new SharedArrayBuffer(1024); +const ta = new Uint8Array(sab); +ta[0] = 5; + +Atomics.xor(ta, 0, 1); // returns 5, the old value +Atomics.load(ta, 0); // 4</pre> + +<h2 id="规范">规范</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('ESDraft', '#sec-atomics.xor', 'Atomics.xor')}}</td> + <td>{{Spec2('ESDraft')}}</td> + <td>Initial definition in ES2017.</td> + </tr> + </tbody> +</table> + +<h2 id="浏览器支持">浏览器支持</h2> + + + +<p>{{Compat("javascript.builtins.Atomics.xor")}}</p> + +<h2 id="相关">相关</h2> + +<ul> + <li>{{jsxref("Atomics")}}</li> + <li>{{jsxref("Atomics.and()")}}</li> + <li>{{jsxref("Atomics.or()")}}</li> +</ul> |