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

CKTIS / Java

Enum.ordinal — a posição de uma constante na declaração

Enum.ordinal devolve a posição, começando em zero, de uma constante enum na respetiva declaração. Não a uses como identificador persistente.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

public final int ordinal()
// Usage: constant.ordinal()

Enum.ordinal é um método de instância sem argumentos, com a assinatura public final int ordinal(). Devolve a posição de uma constante na declaração enum: a primeira tem o valor 0 e a segunda, 1. O modificador final impede que o método seja redefinido.

É uma posição, não um nome nem um código de negócio. Reordenar as constantes ou inserir uma anterior altera os números afetados. Por isso, não os guardes como identificadores persistentes numa base de dados ou num protocolo; define antes um código explícito e estável.

A documentação aponta estruturas como EnumSet e EnumMap como utilizações previstas, e não a lógica habitual de uma aplicação. No exemplo, Stage.NEW, Stage.ACTIVE e Stage.DONE têm, respetivamente, as posições 0, 1 e 2.

Exemplos

public class Main {
    enum Stage { NEW, ACTIVE, DONE }

    public static void main(String[] args) {
        System.out.println(Stage.NEW.ordinal());
        System.out.println(Stage.ACTIVE.ordinal());
        System.out.println(Stage.DONE.ordinal());
    }
}

Resultado

0
1
2

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes