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

CKTIS / Java

java.lang.Enum — representações textuais das constantes

java.lang.Enum é a classe base dos tipos enumerados. Descubra em que difere o método substituível toString() de name(), que devolve o nome exato declarado de uma constante.

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

Sintaxe

public abstract class Enum<E extends Enum<E>>
public String toString()
public final String name()

java.lang.Enum é a classe base comum dos tipos declarados com enum. Um tipo enumerado define constantes com nome, como State.READY.

Por predefinição, Enum.toString() devolve o nome declarado da constante. Pode substituir este método para fornecer um texto mais legível. Em contrapartida, name() é final e devolve sempre o nome exato declarado da constante.

State.valueOf("READY") procura uma constante pelo seu nome exato, não pelo resultado de toString(). A pesquisa distingue maiúsculas de minúsculas; State.valueOf("Ready") lança uma IllegalArgumentException. Por isso, não trate uma etiqueta de apresentação como o nome utilizado para obter uma constante.

Exemplos

public class Main {
    enum State {
        READY;

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

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

Resultado

Ready
READY
true

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