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

CKTIS / Java

List.get(int): ler um elemento de uma lista pelo índice

Lê um elemento pelo seu índice a partir de zero, verifica os limites com size() e distingue um elemento null de um índice fora do intervalo.

Versão: Java SE 21

Sintaxe

E get(int index)
int size()
default Stream<E> stream()
public String getMessage()

E value = list.get(index); // valid when 0 <= index && index < list.size()

Em Java SE 21, List.get refere-se a List.get(int) da interface java.util.List<E>. Devolve o elemento do tipo E no índice indicado, sem o remover nem copiar. Os índices começam em zero, pelo que get(1) lê o segundo elemento.

List.size/get designa a utilização conjunta de size() e get(int), não um método separado. Um índice é válido se 0 <= index && index < list.size(); caso contrário, get lança IndexOutOfBoundsException. Numa lista não vazia, get(0) lê o primeiro elemento e get(list.size() - 1) o último. Uma lista vazia não tem índices válidos. Se a própria referência list for null, chamar list.size() ou list.get(index) lança NullPointerException.

Um índice válido pode corresponder a um elemento null se a lista o permitir. Arrays.asList(10, null, 30) cria uma lista de tamanho fixo assente num array. Podes ler o elemento do meio como Integer, mas o unboxing automático desse null para int lança NullPointerException.

Collection.stream é um método herdado por List que devolve um fluxo sequencial cuja origem é a coleção. Usa get(int) quando conheces a posição e stream() para processar elementos, por exemplo para excluir os null. Aqui, toList() reúne os valores restantes, pela ordem da origem, numa lista não modificável, sem alterar a origem.

Throwable.getMessage devolve a mensagem de detalhe da exceção como String, ou null se não houver mensagem. Não devolve o rastreio da pilha. Podes usar um texto alternativo se a mensagem estiver ausente. Não analises o conteúdo da mensagem para detetar um erro de índice: trata a exceção de acordo com o seu tipo.

Exemplos

import java.util.Arrays;
import java.util.List;
import java.util.Objects;

public class Main {
    public static void main(String[] args) {
        List<Integer> values = Arrays.asList(10, null, 30);
        System.out.println("First: " + values.get(0));
        System.out.println("Last: " + values.get(values.size() - 1));
        Integer middle = values.get(1);
        System.out.println("Middle: " + middle);

        List<Integer> nonNull = values.stream().filter(Objects::nonNull).toList();
        System.out.println("Non-null: " + nonNull.get(0) + ", " + nonNull.get(1));

        try {
            readAt(values, values.size());
        } catch (IndexOutOfBoundsException ex) {
            String message = ex.getMessage();
            System.out.println(message != null ? message : "Invalid index");
        }
    }

    private static <E> E readAt(List<E> list, int index) {
        if (index < 0 || index >= list.size()) {
            throw new IndexOutOfBoundsException("Invalid index: " + index);
        }
        return list.get(index);
    }
}

Resultado

First: 10
Last: 30
Middle: null
Non-null: 10, 30
Invalid index: 3

O índice `1` é válido, mesmo que o elemento seja `null`. Um índice igual a `size()` é inválido: `readAt` rejeita-o antes de chamar `get(int)` e fornece explicitamente a mensagem da exceção.

Lições relacionadas

  • Java · Lição 10 · Avançado · Versão: 2
  • Java · Lição 11 · Avançado · Versão: 2
  • Java · Lição 35 · Avançado · Versão: 2
  • Java · Lição 44 · Avançado · Versão: 2
  • Java · Lição 48 · Avançado · Versão: 2
  • Java · Lição 39 · Básico · Versão: 2
  • Java · Lição 54 · Básico · Versão: 2
  • Java · Lição 58 · Básico · Versão: 2
  • Java · Lição 5 · Intermédio · Versão: 2
  • Java · Lição 6 · Intermédio · Versão: 2
  • Java · Lição 34 · Intermédio · Versão: 2
  • Java · Lição 36 · Intermédio · Versão: 2
  • Java · Lição 41 · Intermédio · Versão: 2
  • Java · Lição 44 · Intermédio · Versão: 2
  • Java · Lição 50 · Intermédio · Versão: 2

Fontes