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

CKTIS / Java

Enum.ordinal — la position d’une constante dans la déclaration

Enum.ordinal renvoie la position, à partir de zéro, d’une constante enum dans sa déclaration. Ne l’utilisez pas comme identifiant persistant.

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

Syntaxe

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

Enum.ordinal est une méthode d’instance sans argument, dont la signature est public final int ordinal(). Elle renvoie la position d’une constante dans sa déclaration enum : la première a la valeur 0, la deuxième 1. Le modificateur final empêche de redéfinir cette méthode.

Il s’agit d’une position, et non d’un nom ni d’un code métier. Réordonner les constantes ou en insérer une avant une autre modifie les nombres concernés. Ne les stockez donc pas comme identifiants persistants dans une base de données ou un protocole ; définissez plutôt un code explicite et stable.

La documentation indique que des structures telles que EnumSet et EnumMap sont des usages prévus, plutôt que la logique habituelle d’une application. Dans l’exemple, Stage.NEW, Stage.ACTIVE et Stage.DONE ont respectivement les positions 0, 1 et 2.

Exemples

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

Résultat

0
1
2

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