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

CKTIS / Java

Enum.name(): o nome exato da constante

Enum.name() devolve o identificador de uma constante enum exatamente como foi declarado. Ao contrário de toString(), não pode ser redefinido.

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

Sintaxe

public final String name()
// Usage: enumConstant.name()

Enum.name é um método de instância com a assinatura public final String name(). Devolve o nome da constante exatamente como foi declarado, preservando as maiúsculas e minúsculas.

name() é final, pelo que não pode ser redefinido. O toString() predefinido devolve o mesmo nome, mas pode ser redefinido para fornecer uma descrição mais fácil de ler.

Utilize name() quando precisar do identificador exato, e não de um rótulo para apresentar. Se o nome da constante for alterado, o resultado também muda; ao guardar estes nomes, trate essa alteração como uma mudança do formato dos dados.

Exemplos

public class Main {
    enum Status {
        READY;

        @Override
        public String toString() {
            return "Ready to start";
        }
    }

    public static void main(String[] args) {
        System.out.println(Status.READY.name());
        System.out.println(Status.READY.toString());
    }
}

Resultado

READY
Ready to start

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