O método JavaScript Array copyWithin () raso copia elementos da matriz para outra posição na matriz, sobrescrevendo os valores existentes.
A sintaxe do copyWithin()método é:
arr.copyWithin(target, start, end)
Aqui, arr é um array.
Parâmetros copyWithin ()
O copyWithin()método inclui:
- target - A posição do índice para a qual copiar os elementos.
- start (opcional) - A posição do índice de onde começar a copiar os elementos. Se omitido, ele copiará do índice 0 .
- end (opcional) - A posição de índice da qual terminar a cópia dos elementos. (exclusivo) Se omitido, copiará até o último índice.
Notas:
- Se algum dos argumentos for negativo, o índice será contado de trás para frente. Por exemplo, -1 representa o último elemento e assim por diante.
- Se o valor de destino for posterior ao início, a sequência copiada será cortada para se ajustar ao comprimento máximo .
Valor de retorno de copyWithin ()
- Retorna a matriz modificada após copiar os elementos.
Notas :
- Este método substitui a matriz original.
- Este método não altera o comprimento da matriz original.
Exemplo: Usando o método copyWithin ()
let array = (1, 2, 3, 4, 5, 6); // target: from second-to-last element, start: 0, end: array.length let returned_arr = array.copyWithin(-2); console.log(returned_arr); // ( 1, 2, 3, 4, 1, 2 ) // modifies the original array console.log(array); // ( 1, 2, 3, 4, 1, 2 ) array = (1, 2, 3, 4, 5, 6); // target: 0, start copying from 5th element array.copyWithin(0, 4); console.log(array); // ( 5, 6, 3, 4, 5, 6 ) array = (1, 2, 3, 4, 5, 6); // target: 1, start copying from 3rd element to second-to-last element array.copyWithin(1, 2, -1); // -1 = last element (exclusive) console.log(array); // ( 1, 3, 4, 5, 5, 6 )
Resultado
(1, 2, 3, 4, 1, 2) (1, 2, 3, 4, 1, 2) (5, 6, 3, 4, 5, 6) (1, 3, 4, 5, 5, 6)
