Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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

Fontes