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

CKTIS / Java

AbstractCollection.toString — représentation textuelle d’une collection

AbstractCollection.toString renvoie les éléments entre crochets, dans l’ordre de l’itérateur, en les séparant par une virgule suivie d’une espace.

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

Syntaxe

public String toString()
collection.toString()

AbstractCollection.toString est une méthode d’instance publique, sans argument, qui renvoie un String. Elle redéfinit Object.toString(). Une sous-classe peut hériter de cette implémentation ou la redéfinir.

Le résultat prend la forme [element1, element2] : les éléments suivent l’ordre renvoyé par iterator(), et le séparateur est ", ". Une collection vide donne []. La méthode ne trie pas elle-même les éléments.

En règle générale, les éléments sont convertis comme avec String.valueOf(Object) : null devient le texte null et, pour un objet non nul, sa méthode toString() est appelée. Dans l’implémentation héritée d’OpenJDK 21, si un élément référence directement la collection elle-même, la méthode insère (this Collection) au lieu d’appeler récursivement la méthode toString() de cette collection. Ce marqueur est un détail d’implémentation que Java SE ne garantit pas. Les chaînes ne sont pas entourées de guillemets supplémentaires ; ne traitez donc pas le résultat comme un format de sérialisation.

L’exemple définit iterator() et size() dans une sous-classe anonyme qui hérite de toString(). Comme l’ordre des données est fixe, le résultat attendu est [red, null, blue].

Exemples

import java.util.AbstractCollection;
import java.util.Arrays;
import java.util.Iterator;
import java.util.List;

public class Main {
    public static void main(String[] args) {
        AbstractCollection<String> values = new AbstractCollection<>() {
            private final List<String> data = Arrays.asList("red", null, "blue");

            @Override
            public Iterator<String> iterator() {
                return data.iterator();
            }

            @Override
            public int size() {
                return data.size();
            }
        };

        System.out.println(values.toString());
    }
}

Résultat

[red, null, blue]

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