JavaScript Atomics sub()用法及代碼示例

在 Atomic Operations 中，有一個方法 Atomics.sub() 用於減去數組中給定位置的給定值並返回該位置的舊值。在寫回修改的值之前，不能發生其他寫入操作。

用法:

Atomics.sub(typedArray, index, value)

參數：

• typedarray：它是您要修改的共享整數類型數組。
• index：它是 typedArray 中要從中減去值的位置。
• value：這是您要減去的數字。

返回值：Atomics.sub() 返回給定位置 (typedArray[index]) 的舊值。

下麵提供了上述函數的示例。

例子：

Input : arr[0] = 9;
        Atomics.sub(arr, 0, 3);
Output : 9
 

Input : arr[0] = 3; 
        Atomics.sub(arr, 0, 2);
Output : 3

下麵提供了上述函數的示例。

示例 1：

// creating a SharedArrayBuffer 
let buf = new SharedArrayBuffer(25); 
let arr = new Uint8Array(buf); 
// Initialising element at zeroth position of array with 9 
arr[0] = 9; 
  
// Displaying the return value of the Atomics.sub() method  
console.log(Atomics.sub(arr, 0, 3)); 
  
// Displaying the updated SharedArrayBuffer  
console.log(Atomics.load(arr, 0));

輸出：

9
6

示例 2：

// creating a SharedArrayBuffer  
let buf = new SharedArrayBuffer(25); 
let arr = new Uint8Array(buf); 
  
// Initialising element at zeroth position of array with 3 
arr[0] = 3; 
  
// Displaying the return value of the Atomics.sub() method  
console.log(Atomics.sub(arr, 0, 2)); 
  
// Displaying the updated SharedArrayBuffer  
console.log(Atomics.load(arr, 0));

輸出：

3
1

應用：每當我們想要更新(減去)給定數組中指定位置的值並希望返回該位置的舊值時，我們就使用 JavaScript 中的 Atomics.sub() 操作。

例子：

// creating a SharedArrayBuffer  
let mybuffer = new SharedArrayBuffer(25); 
let myarray = new Uint8Array(mybuffer); 
  
// Initialising the element at zeroth position of array 
myarray[0] = 40; 
  
// Displaying the return value of the Atomics.sub() method 
console.log(Atomics.sub(myarray, 0, 20)); 
  
// Displaying the updated SharedArrayBuffer  
console.log(Atomics.load(myarray, 0));

輸出：

40
20

異常：

• 如果 typedArray 不是允許的整數類型之一，則 Atomics.sub() 操作會引發 TypeError。
• 如果 typedArray 不是共享類型數組，則 Atomics.sub() 操作會拋出 TypeError。
• 如果用作 Atomics.sub() 操作參數的索引超出 typedArray 中的範圍，則 Atomics.sub() 操作將引發 RangeError。

支持的瀏覽器：

• 穀歌瀏覽器
• 微軟邊
• Firefox
• Opera
• Safari

我們有 Javascript 原子方法的完整列表，要檢查這些方法，請閱讀這篇JavaScript Atomics Complete Reference 文章。

我們有一份關於 Javascript 的備忘單，其中涵蓋了 Javascript 的所有重要主題，請查看這些主題Javascript Cheat Sheet-A JavaScript 基本指南.