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

CKTIS / Java

Object.toString — la représentation textuelle d’un objet

Object.toString renvoie la représentation textuelle d’un objet. Redéfinir cette méthode permet de fournir un texte lisible et utile au diagnostic.

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

Syntaxe

public String toString()

Object.toString est une méthode d’instance publique, sans paramètre, qui renvoie une String. Son résultat devrait décrire l’objet de manière concise et lisible.

L’implémentation par défaut renvoie getClass().getName() + '@' + Integer.toHexString(hashCode()) : le nom de la classe, @ et le code de hachage en hexadécimal. Il ne s’agit ni d’un identifiant unique garanti ni d’une adresse mémoire.

Redéfinissez public String toString() avec l’annotation @Override pour décrire les éléments d’état pertinents. Dans l’exemple, une variable de type Object fait référence à un Point ; l’appel sélectionne donc l’implémentation Point.toString().

Le résultat n’a pas besoin de rester stable dans le temps ni d’un lancement de la JVM à l’autre. Ne le considérez pas comme un format de données persistant et évitez d’y exposer des secrets.

Exemples

public class Main {
    static final class Point {
        private final int x;
        private final int y;

        Point(int x, int y) {
            this.x = x;
            this.y = y;
        }

        @Override
        public String toString() {
            return "Point[x=" + x + ", y=" + y + "]";
        }
    }

    public static void main(String[] args) {
        Object point = new Point(2, 3);
        System.out.println(point.toString());
    }
}

Résultat

Point[x=2, y=3]

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