Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

java.lang.Enum — représentations textuelles des constantes

java.lang.Enum est la classe de base des types énumérés. Découvrez en quoi toString(), qui peut être redéfinie, diffère de name(), qui renvoie le nom exact déclaré d’une constante.

Version : Java SE 21; repository runtime, production runtime not attested

Syntaxe

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

java.lang.Enum est la classe de base commune des types déclarés avec enum. Un type énuméré définit des constantes nommées, telles que State.READY.

Par défaut, Enum.toString() renvoie le nom déclaré de la constante. Vous pouvez redéfinir cette méthode pour fournir un texte plus lisible. En revanche, name() est final et renvoie toujours le nom exact déclaré de la constante.

State.valueOf("READY") recherche une constante à partir de son nom exact, et non du résultat de toString(). La casse est prise en compte ; State.valueOf("Ready") déclenche une IllegalArgumentException. Ne considérez donc pas un libellé destiné à l’affichage comme le nom à utiliser pour récupérer une constante.

Exemples

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);
    }
}

Résultat

Ready
READY
true

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources