diff options
Diffstat (limited to 'files/zh-cn/web/javascript/reference/global_objects/sharedarraybuffer/slice/index.html')
-rw-r--r-- | files/zh-cn/web/javascript/reference/global_objects/sharedarraybuffer/slice/index.html | 76 |
1 files changed, 76 insertions, 0 deletions
diff --git a/files/zh-cn/web/javascript/reference/global_objects/sharedarraybuffer/slice/index.html b/files/zh-cn/web/javascript/reference/global_objects/sharedarraybuffer/slice/index.html new file mode 100644 index 0000000000..a13b9885f3 --- /dev/null +++ b/files/zh-cn/web/javascript/reference/global_objects/sharedarraybuffer/slice/index.html @@ -0,0 +1,76 @@ +--- +title: SharedArrayBuffer.prototype.slice() +slug: Web/JavaScript/Reference/Global_Objects/SharedArrayBuffer/slice +tags: + - SharedArrayBuffer + - slice +translation_of: Web/JavaScript/Reference/Global_Objects/SharedArrayBuffer/slice +--- +<div>{{JSRef}}</div> + +<p><code><strong>SharedArrayBuffer.prototype.slice()</strong></code> 方法返回一个新的{{jsxref("SharedArrayBuffer")}} 副本,其内容是<code>该SharedArrayBuffer</code>的字节从<code>begin</code>开始(包含<code>begin</code>),直到<code>end</code>结束(不包含<code>end</code>)。如果<code>begin</code>或<code>end</code>是负的,它指的是从数组末尾开始的索引。此方法与 {{jsxref("Array.prototype.slice()")}} 具有相同的算法。</p> + +<p>{{EmbedInteractiveExample("pages/js/sharedarraybuffer-slice.html")}}</p> + +<h2 id="语法">语法</h2> + +<pre class="syntaxbox"><var>sab</var>.slice() +<var>sab</var>.slice(begin) +<var>sab</var>.slice(begin, end)</pre> + +<h3 id="参数">参数</h3> + +<dl> + <dt><code>begin</code> {{optional_inline}}</dt> + <dd>从零开始的索引,从该索引开始提取。</dd> + <dd>可以使用一个负索引,表示从序列末尾开始的偏移量。 <code>slice(-2)</code>提取序列中的最后两个元素。</dd> + <dd>If <code>begin</code> is undefined, <code>slice</code> begins from index <code>0</code>.如果<code>begin</code>为undefined,<code>slice</code>则从索引为<code>0</code>处开始。</dd> + <dt><code>end</code> {{optional_inline}}</dt> + <dd>从零开始的索引,在此索引<em>之前</em>终止提取。 <code>slice</code> 执行提取到索引为<code>end</code>的位置(不包含<code>end</code>)。</dd> + <dd>例如,<code>slice(1,4)</code>提取第二个元素到第四个元素(索引为1、2和3的元素)。</dd> + <dd>可以使用一个负索引,表示从序列末尾开始的偏移量。 <code>slice(2,-1)</code>提取序列中从第三个元素开始,到倒数第二个元素结束的全部元素。</dd> + <dd>如果省略<code>end</code>,则<code>slice</code>一直提取到序列的末尾(<code>sab.byteLength)。</code></dd> +</dl> + +<h3 id="返回值">返回值</h3> + +<p>一个包含被提取出的元素的新 {{jsxref("SharedArrayBuffer")}} 。</p> + +<h2 id="例子">例子</h2> + +<pre class="brush:js">var sab = new SharedArrayBuffer(1024); +sab.slice(); // SharedArrayBuffer { byteLength: 1024 } +sab.slice(2); // SharedArrayBuffer { byteLength: 1022 } +sab.slice(-2); // SharedArrayBuffer { byteLength: 2 } +sab.slice(0, 1); // SharedArrayBuffer { byteLength: 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('ESDraft', '#sec-sharedarraybuffer.prototype.slice', 'SharedArrayBuffer.prototype.slice')}}</td> + <td>{{Spec2('ESDraft')}}</td> + <td>Initial definition in ES2017.</td> + </tr> + </tbody> +</table> + +<h2 id="浏览器兼容性">浏览器兼容性</h2> + + + +<p>{{Compat("javascript.builtins.SharedArrayBuffer.slice")}}</p> + +<h2 id="相关链接">相关链接</h2> + +<ul> + <li>{{jsxref("SharedArrayBuffer")}}</li> + <li>{{jsxref("Array.prototype.slice()")}}</li> +</ul> |