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

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

Fontes