Atomics.xor()
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Dezember 2021 browserübergreifend verfügbar.
Die Atomics.xor() statische Methode führt einen bitweisen XOR mit einem gegebenen Wert an einer gegebenen Position im Array durch und gibt den alten Wert an dieser Position zurück. Diese atomare Operation garantiert, dass kein anderer Schreibvorgang erfolgt, bis der modifizierte Wert zurückgeschrieben wird.
Syntax
Atomics.xor(typedArray, index, value)
Parameter
typedArray-
Ein ganzzahliges typisiertes Array. Eins von
Int8Array,Uint8Array,Int16Array,Uint16Array,Int32Array,Uint32Array,BigInt64ArrayoderBigUint64Array. index-
Die Position im
typedArray, an der der bitweise XOR berechnet werden soll. value-
Die Zahl, mit der der bitweise XOR berechnet wird.
Rückgabewert
Der alte Wert an der angegebenen Position (typedArray[index]).
Ausnahmen
TypeError-
Wird ausgelöst, wenn
typedArraynicht einer der erlaubten ganzzahligen Typen ist. RangeError-
Wird ausgelöst, wenn
indexaußerhalb der Grenzen destypedArrayliegt.
Beschreibung
Die bitweise XOR-Operation ergibt 1, wenn a und b unterschiedlich sind. Die Wahrheitstabelle für die XOR-Operation ist:
a |
b |
a ^ b |
|---|---|---|
| 0 | 0 | 0 |
| 0 | 1 | 1 |
| 1 | 0 | 1 |
| 1 | 1 | 0 |
Zum Beispiel ergibt ein bitweises XOR von 5 ^ 1 0100, was im Dezimalsystem 4 ist.
5 0101 1 0001 ---- 4 0100
Beispiele
Beachten Sie, dass diese Beispiele nicht direkt aus der Konsole oder einer beliebigen Webseite ausgeführt werden können, da SharedArrayBuffer nicht definiert ist, es sei denn, die Sicherheitsanforderungen sind erfüllt.
Verwendung von Atomics.xor()
// Create a SharedArrayBuffer with a size in bytes
const sab = new SharedArrayBuffer(1024);
// Create a view and set the value of the 0 index
const ta = new Uint8Array(sab);
ta[0] = 7;
// 7 (0111) XOR 2 (0010) = 5 (0101)
console.log(Atomics.xor(ta, 0, 2)); // 7, the old value
console.log(Atomics.load(ta, 0)); // 5, the new/current value
Spezifikationen
| Spezifikation |
|---|
| ECMAScript® 2026 Language Specification # sec-atomics.xor |