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