CKTIS / Java
List.set — Substituir um elemento da lista pelo índice
`List.set(int,E)` substitui o elemento num índice existente e devolve o elemento anterior. Não altera o tamanho da lista nem desloca os restantes elementos.
Versão: Java SE 21
Sintaxe
E set(int index, E element)List.set é um método de instância de java.util.List<E>. A assinatura List.set(int,E) indica que list.set(index, element) recebe um índice do tipo int e um novo elemento do tipo E, e devolve o elemento que estava nesse índice, também do tipo E.
Os índices começam em zero. Um índice válido satisfaz 0 <= index < list.size(); fora desse intervalo, uma lista que suporta set lança IndexOutOfBoundsException. Ao contrário de add(index, element), set não insere um elemento, não desloca os restantes nem altera size(). O índice list.size() pode ser usado para inserir no fim, mas não para substituir um elemento.
set é uma operação opcional: ArrayList suporta-a, mas uma lista criada com List.of(...) lança UnsupportedOperationException. Um tamanho fixo não impede a substituição: Arrays.asList(...) suporta set com um elemento compatível, e a alteração é visível no array. Consoante a lista, um null não permitido pode causar NullPointerException, um tipo não permitido ClassCastException e outra propriedade não permitida do elemento IllegalArgumentException.
subList(from, to) devolve uma vista, não uma cópia: inclui from e exclui to. Os índices da vista começam em zero, pelo que window.set(i, value) altera o índice from + i na lista subjacente, se esta suportar set. Se a estrutura dessa lista for alterada sem ser através da vista, o comportamento da vista fica indefinido.
Exemplos
import java.util.ArrayList;
import java.util.List;
public class Main {
public static void main(String[] args) {
List<String> base = new ArrayList<>(List.of("A", "B", "C", "D", "E"));
List<String> window = base.subList(2, 4);
int sizeBefore = base.size();
String firstOld = window.set(0, "X");
String secondOld = window.set(1, "Y");
System.out.println("old=" + firstOld + ", " + secondOld);
System.out.println("window=" + window);
System.out.println("base=" + base);
System.out.println("size=" + sizeBefore + " -> " + base.size());
}
}
Resultado
old=C, D window=[X, Y] base=[A, B, X, Y, E] size=5 -> 5
As duas chamadas a `set` substituem `C` e `D` por `X` e `Y`. Os índices `0` e `1` em `window` correspondem a `2` e `3` em `base`; a lista subjacente continua a ter `5` elementos.
Lições relacionadas
- Java · Lição 21 · Avançado · Versão: 2
- Java · Lição 54 · Básico · Versão: 2
- Java · Lição 6 · Intermédio · Versão: 2
- Java · Lição 34 · Intermédio · Versão: 2