JavaScript - TypedArray copyWithin() 方法

JavaScript TypedArray 的 copyWithin() 方法将 TypedArray 内的元素复制到另一个位置，并返回修改后的 TypedArray，而不会改变其原始长度。它接受三个参数，其中一个名为目标。

如果target参数值为负数，它将从 TypedArray 的末尾开始插入元素。例如，如果target = -1，则值将插入到当前 TypedArray 的末尾。

在 JavaScript 中，TypedArray 是类似数组的对象，提供了一种在内存缓冲区中读取和写入原始二进制数据的机制。

语法

以下是 JavaScript TypedArray copyWithin() 方法的语法：

copyWithin(target, start, end)

参数

此方法接受三个名为“target”、“start”和“end”的参数，如下所述：

target - 元素开始插入的基于零的索引（位置）。
start - 元素开始复制的基于零的索引。
end (可选) - 停止复制元素的基于零的索引。该方法最多复制到 end，但不包括 end 本身。

返回值

此方法返回修改后的 TypedArray，而不会更改原始 TypedArray 的长度。

示例

示例 1

如果我们只将target和start参数传递给此方法，它将从指定的 target 位置（为3）开始插入元素，并从原始 TypedArray 中指定的 start 位置（为0）开始复制元素，直到复制的元素长度等于原始 TypedArray ([1, 2, 3, 4, 5, 6, 7, 8])。

<html>
<head>
   <title>JavaScript TypedArray copyWithin() Method</title>
</head>
<body>
   <script>
      const T_array = new Uint8Array([1, 2, 3, 4, 5, 6, 7, 8]);
      document.write("Original TypedArray: ", T_array);
      const target = 3;
      const start = 0;
      document.write("<br>Target(start insert) position at: ", target);
      document.write("<br>Start copying position at: ", start);
      T_array.copyWithin(target, start);
      document.write("<br>Modified TypedArray: ", T_array);
   </script>    
</body>
</html>

输出

上述程序返回修改后的 TypedArray：[1,2,3,1,2,3,4,5]。

Original TypedArray: 1,2,3,4,5,6,7,8
Target(start insert) position at: 3
Start copying position at: 0
Modified TypedArray: 1,2,3,1,2,3,4,5

示例 2

如果我们将所有三个参数(target、start 和 end)传递给此方法，它将从指定的 target 位置（为4）开始插入元素，并从原始 TypedArray 中指定的 start 位置（为1）开始复制元素，直到但不包括指定的 end 位置（为3）。其余元素保持不变。

<html>
<head>
   <title>JavaScript TypedArray copyWithin() Method</title>
</head>
<body>
   <script>
      const T_array = new Uint8Array([1, 2, 3, 0, 0, 0, 0, 0]);
      document.write("Original TypedArray: ", T_array);
      const target = 4;
      const start = 1;
      const end = 3;
      document.write("<br>Target(start insert) position at: ", target);
      document.write("<br>Start copying position at: ", start);
      document.write("<br>End(stop copying) position at: ", end);
      T_array.copyWithin(target, start, end);
      document.write("<br>Modified TypedArray: ", T_array);
   </script>    
</body>
</html>

输出

执行上述程序后，它将返回修改后的 TypedArray：[1,2,3,0,2,3,0,0]。

Original TypedArray: 1,2,3,0,0,0,0,0
Target(start insert) position at: 4
Start copying position at: 1
End(stop copying) position at: 3
Modified TypedArray: 1,2,3,0,2,3,0,0

示例 3

如果 target 参数值为负数(-1)，它将在此 TypedArray [1, 2, 3, 4, 5, 6, 7, 8] 的末尾插入元素。

<html>
<head>
   <title>JavaScript TypedArray copyWithin() Method</title>
</head>
<body>
   <script>
      const T_array = new Uint8Array([1, 2, 3, 4, 5, 6, 7, 8]);
      document.write("Original TypedArray: ", T_array);
      const target = -1;
      const start = 1;
      const end = 3;
      document.write("<br>Target(start insert) position at: ", target);
      document.write("<br>Start copying position at: ", start);
      document.write("<br>End(stop copying) position at: ", end);
      T_array.copyWithin(target, start, end);
      document.write("<br>Modified TypedArray: ", T_array);
   </script>    
</body>
</html>

输出

执行上述程序后，它将返回修改后的 TypedArray：

Original TypedArray: 1,2,3,4,5,6,7,8
Target(start insert) position at: -1
Start copying position at: 1
End(stop copying) position at: 3
Modified TypedArray: 1,2,3,4,5,6,7,2

打印页面