Array.prototype.copyWithin()
Il metodo copyWithin()
copia superficialmente una parte di un array in un'altra locazione dello stesso array e lo restituisce, senza modificare la sua dimensione.
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
Il codice sorgente di questo esempio interattivo e' reperibile in una repository di GitHub. Se sei interessato nel contribuire agli esempi interattivi, clona https://github.com/mdn/interactive-examples ed inviaci una pull request.
Sintassi
arr.copyWithin(target) arr.copyWithin(target, start) arr.copyWithin(target, start, end)
Parametri
target
- Indice zero-based fino al quale copiare la sequenza. Se negativo,
target
sarà impostato all'ultimo elemento dell'array. - Se
target
è pari o più grande diarr.length
, non sarà copiato nulla. Setarget
è posizionato dopostart
, la sequenza copiata, sarà ritagliata per poter rientrare inarr.length
. start
Optional- Indice zero-based dal quale si comincia a copiare gli elementi. Se negativo,
start
comincerà a contare dalla fine. - Se
start
è omesso,copyWithin
copierà dall'inizio (default 0). end
Optional- Indice zero-based che indica l'ultimo indice dal quale copiare.
copyWithin
copia fino adend
ma non lo include. Se negativo,end
sarà contato dalla fine. - Se
end
è omesso,copyWithin
copierà fino alla fine (defaultarr.length
).
Valore di ritorno
L'array modificato.
Descrizione
copyWithin
ha le stesse funzionalità di memmove
provenienti da C e C++, ed è un metodo molto performante per spostare i dati di un Array
. Questa modifica si applica specialmente a TypedArray
metodo con lo stesso nome. La sequenza è copiata e incollata come una singola operzione; la sequenza incollata avrà i valori copiati anche se essi si sovrappongono.
La funzione copyWithin
è intenzionalmente generic, e non richiede che i suoi argomenti siano Array
object.
copyWithin
è un metodo mutabile. Non altera la lunghezza di this
, ma cambia il suo contenuto e crea nuove proprietà se necessario..
Esempi
[1, 2, 3, 4, 5].copyWithin(-2);
// [1, 2, 3, 1, 2]
[1, 2, 3, 4, 5].copyWithin(0, 3);
// [4, 5, 3, 4, 5]
[1, 2, 3, 4, 5].copyWithin(0, 3, 4);
// [4, 2, 3, 4, 5]
[1, 2, 3, 4, 5].copyWithin(-2, -3, -1);
// [1, 2, 3, 3, 4]
[].copyWithin.call({length: 5, 3: 1}, 0, 3);
// {0: 1, 3: 1, length: 5}
// ES2015 Typed Arrays are subclasses of Array
var i32a = new Int32Array([1, 2, 3, 4, 5]);
i32a.copyWithin(0, 2);
// Int32Array [3, 4, 5, 4, 5]
// On platforms that are not yet ES2015 compliant:
[].copyWithin.call(new Int32Array([1, 2, 3, 4, 5]), 0, 3, 4);
// Int32Array [4, 2, 3, 4, 5]
Polyfill
if (!Array.prototype.copyWithin) { Array.prototype.copyWithin = function(target, start/*, end*/) { // Steps 1-2. if (this == null) { throw new TypeError('this is null or not defined'); } var O = Object(this); // Steps 3-5. var len = O.length >>> 0; // Steps 6-8. var relativeTarget = target >> 0; var to = relativeTarget < 0 ? Math.max(len + relativeTarget, 0) : Math.min(relativeTarget, len); // Steps 9-11. var relativeStart = start >> 0; var from = relativeStart < 0 ? Math.max(len + relativeStart, 0) : Math.min(relativeStart, len); // Steps 12-14. var end = arguments[2]; var relativeEnd = end === undefined ? len : end >> 0; var final = relativeEnd < 0 ? Math.max(len + relativeEnd, 0) : Math.min(relativeEnd, len); // Step 15. var count = Math.min(final - from, len - to); // Steps 16-17. var direction = 1; if (from < to && to < (from + count)) { direction = -1; from += count - 1; to += count - 1; }
// Step 18. while (count > 0) { if (from in O) { O[to] = O[from]; } else { delete O[to]; } from += direction; to += direction; count--; } // Step 19. return O; }; }
Specificazioni
Specification | Status | Comment |
---|---|---|
ECMAScript 2015 (6th Edition, ECMA-262) The definition of 'Array.prototype.copyWithin' in that specification. |
Standard | Definizione iniziale. |
ECMAScript 2016 (ECMA-262) The definition of 'Array.prototype.copyWithin' in that specification. |
Standard | |
ECMAScript (ECMA-262) The definition of 'Array.prototype.copyWithin' in that specification. |
Living Standard |
Compatibilità browser
BCD tables only load in the browser