WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Float32Array: 32-Bit-Gleitkommawerte

Float32Array speichert Number-Werte als 32-Bit-Zahlen nach IEEE 754 mit 4 Byte je Element.

Version: ECMAScript 2015 onward; example target: Node.js 24.22.2

Syntax

new Float32Array(); new Float32Array(length); new Float32Array(source); new Float32Array(buffer[, byteOffset[, length]])

new Float32Array(source?, byteOffset?, length?) erzeugt ein numerisches Typed Array. Quelle kann Länge, Iterable oder array-ähnlicher Wert, ein anderes numerisches Typed Array oder ArrayBuffer/SharedArrayBuffer sein; die Pufferform ist eine Ansicht ohne Kopie. byteOffset muss durch 4 teilbar sein, BYTES_PER_ELEMENT ist 4.

Beim Schreiben durchläuft ein Wert ToNumber und wird auf den nächsten darstellbaren binary32-Wert gerundet. Daher ändert sich 0.1 leicht und 16777217 wird 16777216; NaN, Unendlichkeiten und das Vorzeichen von -0 werden unterstützt. BigInt beim Schreiben oder ein BigInt Typed Array als Quelle löst TypeError aus. Die Byteordnung ist nativ; für ein festes Format dient DataView.

Die Länge durchläuft ToIndex: Brüche werden gegen null abgeschnitten, NaN/undefined werden 0 und -0.5 ebenfalls 0. Negatives Ergebnis nach ToIntegerOrInfinity, Unendlichkeit, falsch ausgerichteter Offset oder Bereich außerhalb des Puffers ergibt RangeError; ein abgelöster Puffer TypeError. Der Typ ist seit ECMAScript 2015 standardisiert.

Beispiele

const values = new Float32Array([0.1, 16777217, -0, Infinity]);
console.log(values[0]);
console.log(values[1]);
console.log(Object.is(values[2], -0), values[3]);
console.log(Float32Array.BYTES_PER_ELEMENT, new Float32Array(2.9).length, new Float32Array(-0.5).length);
try { values[0] = 1n; } catch (error) { console.log(error instanceof TypeError); }

Ergebnis

0.10000000149011612
16777216
true Infinity
4 2 0
true

Quellen