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