CKTIS / JavaScript
Tablice typowane: widok `subarray()` a kopia `slice()`
`subarray()` tworzy widok na ten sam bufor, a `slice()` domyślnie kopiuje wybrane elementy do osobnego bufora. Obie metody tak samo interpretują granice zakresu.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
typedArray.subarray()
typedArray.subarray(start)
typedArray.subarray(start, end)
typedArray.slice()
typedArray.slice(start)
typedArray.slice(start, end)subarray() i slice() to metody wspólnego prototypu, które dziedziczą instancje takie jak Uint16Array. Nie istnieje globalny konstruktor TypedArray. Obie metody wymagają jako this rzeczywistej tablicy typowanej; zwykła tablica Array powoduje TypeError.
Obie metody używają indeksów elementów widoku od zera, a nie pozycji bajtowych w buforze, jak ArrayBuffer.prototype.slice(). Początek jest włączony, a koniec wyłączony. Pominięcie start lub podanie undefined oznacza 0; pominięcie end lub podanie undefined oznacza koniec widoku. Część ułamkową odrzuca się w kierunku zera; ujemne indeksy liczy się od końca. Granice ogranicza się do przedziału od 0 do długości widoku. Jeśli po przeliczeniu koniec nie wypada za początkiem, obie metody zwracają pustą tablicę typowaną dla prawidłowego widoku na bufor o stałym rozmiarze przy domyślnym konstruktorze wyniku. Niestandardowy konstruktor wskazany przez constructor[Symbol.species] może zwrócić niepustą tablicę typowaną nawet wtedy, gdy przekazana mu długość wynosi 0.
Przy domyślnym konstruktorze wyniku subarray() tworzy nowy widok na ten sam bufor bez kopiowania elementów. Zapisy w nakładającym się obszarze są widoczne w obu widokach. Nawet mały widok może utrzymywać cały bufor w pamięci, a jego .buffer udostępnia również bajty spoza zakresu. Użyj slice(), aby uzyskać niezależną kopię wybranych elementów. Niestandardowe constructor[Symbol.species] może uruchomić kod, zmienić typ elementów lub zmienić to, czy wynik współdzieli pamięć. Nie traktuj tych metod jako granicy bezpieczeństwa dla niezaufanych obiektów.
W ECMAScript 2024, przy domyślnym konstruktorze, subarray() widoku śledzącego długość również śledzi długość bufora, gdy end jest pominięte lub ma wartość undefined. Jawna granica inna niż undefined daje widok o stałej długości, a slice() domyślnie daje kopię o stałej długości. Gdy bufor jest odłączony lub widok wykracza poza bufor już w chwili wywołania, slice() zgłasza TypeError. subarray() przyjmuje wtedy długość źródła równą 0 na potrzeby obliczeń, ale samo tworzenie widoku nadal może się nie udać. Sprawdź obsługę buforów o zmiennym rozmiarze w docelowym środowisku wykonawczym.
Przykłady
{
const source = new Uint16Array([10, 20, 30, 40]);
const view = source.subarray(1, -1);
const copy = source.slice(1, -1);
view[0] = 99;
source[2] = 77;
console.log(`source: ${source.join(', ')}`);
console.log(`view: ${view.join(', ')}`);
console.log(`copy: ${copy.join(', ')}`);
console.log(`same buffer: ${view.buffer === source.buffer}, ${copy.buffer === source.buffer}`);
}Wynik
source: 10, 99, 77, 40 view: 99, 77 copy: 20, 30 same buffer: true, false
`(1, -1)` wybiera `20` i `30`. Zapis przez `view` zmienia `source`, a zapis przez `source` zmienia `view`. `copy` zachowuje wartości `20, 30` i ma osobny bufor.
Powiązane lekcje
- JavaScript · Lekcja 2 · Zaawansowany · Wersja: 4
Źródła
- ECMAScript® 2024 Language Specification — %TypedArray%.prototype.subarray
- ECMAScript® 2024 Language Specification — %TypedArray%.prototype.slice
- ECMAScript® 2024 Language Specification — TypedArraySpeciesCreate
- TypedArray.prototype.subarray() - JavaScript | MDN
- TypedArray.prototype.slice() - JavaScript | MDN
- TypedArray - JavaScript | MDN
- TypedArray[Symbol.species] - JavaScript | MDN
- ArrayBuffer.prototype.slice() - JavaScript | MDN