CKTIS / Java
List.size() — número de elementos de uma lista
`List.size()` devolve o número de elementos de uma lista como um `int`. Usa-o para verificar um número mínimo de elementos ou definir um limite superior exclusivo para os índices.
Versão: Java SE 21
Sintaxe
int size()
int n = list.size();List.size é uma forma abreviada de indicar o método List.size() da interface java.util.List em Java SE 21. É um método de instância sem argumentos: chama list.size(), não List.size(). Devolve um int e não altera a lista.
Uma lista vazia tem tamanho 0. Cada ocorrência conta separadamente, incluindo elementos null se a lista os permitir. Se a lista tiver mais de Integer.MAX_VALUE elementos, o método devolve Integer.MAX_VALUE. Se a própria referência list for null, a chamada lança uma NullPointerException.
O tamanho não é a capacidade interna: new ArrayList<>(8) cria uma lista vazia com capacidade inicial de 8. Para um array, lê o campo array.length, sem parênteses. ArrayList.size() é executado em tempo constante, mas List não o garante para todas as implementações.
Usa list.isEmpty() se só precisares de verificar se a lista está vazia. A condição n >= 2 verifica se existem pelo menos dois elementos. Com n = list.size(), usa 0 <= i && i < n para list.get(i); i == n provoca uma IndexOutOfBoundsException. O valor guardado em n não se atualiza automaticamente: lê novamente o tamanho após uma alteração se precisares do limite atual.
Exemplos
import java.util.ArrayList;
import java.util.List;
public class ListSizeExample {
public static void main(String[] args) {
List<String> colors = new ArrayList<>(8);
System.out.println("size = " + colors.size());
colors.add("red");
colors.add("blue");
colors.add("red");
int n = colors.size();
System.out.println("size = " + n);
if (n < 2) {
return;
}
for (int i = 1; i < n; i++) {
System.out.println(i + ": " + colors.get(i));
}
}
}Resultado
size = 0 size = 3 1: blue 2: red
O programa escreve primeiro `0`, apesar da capacidade inicial de 8. Após três adições, escreve `3`, porque as duas ocorrências de `red` contam. O teste `n < 2` terminaria o programa se não houvesse um segundo elemento. O ciclo começa no índice `1`, pelo que escreve `blue` e o último `red`.
Lições relacionadas
- Java · Lição 11 · Avançado · Versão: 2
- Java · Lição 12 · Avançado · Versão: 2
- Java · Lição 13 · Avançado · Versão: 2
- Java · Lição 14 · Avançado · Versão: 2
- Java · Lição 22 · Avançado · Versão: 2
- Java · Lição 35 · 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 62 · Básico · Versão: 2
- Java · Lição 2 · Intermédio · Versão: 2
- Java · Lição 6 · Intermédio · Versão: 2
- Java · Lição 33 · 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 43 · Intermédio · Versão: 2
- Java · Lição 44 · Intermédio · Versão: 2
- Java · Lição 50 · Intermédio · Versão: 2
- Java · Lição 57 · Intermédio · Versão: 2