CKTIS / JavaScript
Lunghezza e indicizzazione degli array tipizzati
`length` conta gli elementi della vista, non i byte. Gli indici partono da zero e scrivere oltre l’ultimo elemento non estende la vista.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
view.length
view[index]
view[index] = value
view.at(index)
new Uint16Array(buffer, byteOffset)
new Uint16Array(buffer, byteOffset, length)Un array tipizzato, come Uint16Array, è una vista su un buffer. view.length è una proprietà ereditata con un getter ma senza setter. Conta gli elementi; view.byteLength conta i byte della vista e view.buffer.byteLength quelli dell’intero buffer. Un’assegnazione a view.length non ridimensiona la vista e in modalità strict genera un TypeError.
Gli indici degli elementi sono interi da 0 a view.length - 1. view[0] e view["0"] fanno riferimento allo stesso elemento. Le chiavi "01" e "1.0" sono normali nomi di proprietà, non indici di elementi. view[-0] si comporta come view[0], ma view["-0"] restituisce undefined.
La lettura a un indice di elemento non valido restituisce undefined. Scrivere a quell’indice non modifica il buffer né aggiunge elementi, nemmeno in modalità strict, se la conversione del valore riesce. La conversione può comunque generare un errore, ad esempio se si scrive un Number in un BigInt64Array. A un indice valido, il valore viene memorizzato secondo il tipo dell’elemento. view[-1] non conta dalla fine; view.at(-1) invece restituisce l’ultimo elemento di una vista non vuota.
Se il costruttore riceve un ArrayBuffer ridimensionabile o uno SharedArrayBuffer espandibile, omettere il terzo argomento length (o passare undefined) crea una vista la cui lunghezza si adatta al numero di elementi interi da byteOffset alla fine attuale del buffer. Con un buffer di dimensioni fisse, la stessa chiamata crea una vista di lunghezza fissa. In questo caso, il numero di byte da byteOffset alla fine del buffer deve essere un multiplo della dimensione in byte di un elemento; altrimenti il costruttore genera un RangeError. Una lunghezza esplicita fissa il numero di elementi finché la vista rientra nel buffer. Se il buffer si restringe e la vista ne oltrepassa i limiti, length vale 0; un successivo ampliamento può riportare la vista entro i limiti. Anche il distacco del buffer dà length === 0. In entrambi i casi le letture per indice restituiscono undefined, ma at() genera un TypeError.
Esempi
"use strict";
{
const view = new Uint16Array([10, 20]);
view[1] = 65537;
view[view.length] = 99;
console.log(`${view.length} ${view.byteLength}`);
console.log(`${view[0]} ${view[1]}`);
console.log(`${view[view.length]} ${view[-1]} ${view.at(-1)}`);
}Risultato
2 4 10 1 undefined undefined 1
Due elementi di `Uint16Array` occupano quattro byte. Memorizzare `65537` dà `1`, perché si conservano solo i 16 bit meno significativi. Scrivere all’indice `2` non estende la vista; `at(-1)` legge l’ultimo elemento.
Lezioni correlate
- JavaScript · Lezione 33 · Avanzato · Versione: 4
- JavaScript · Lezione 34 · Avanzato · Versione: 4