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

CKTIS / Java

AbstractCollection.toString — representação textual de uma coleção

AbstractCollection.toString devolve os elementos entre parênteses retos, pela ordem do iterador e separados por uma vírgula e um espaço.

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

Sintaxe

public String toString()
collection.toString()

AbstractCollection.toString é um método de instância público, sem argumentos, que devolve um String. Substitui Object.toString(). Uma subclasse pode herdar esta implementação ou substituí-la.

O resultado tem a forma [element1, element2]: os elementos seguem a ordem devolvida por iterator() e o separador é ", ". Uma coleção vazia produz []. O método não ordena os elementos por si próprio.

Em geral, os elementos são convertidos como em String.valueOf(Object): null passa a ser o texto null e, se o objeto não for null, é chamado o respetivo método toString(). Na implementação herdada do OpenJDK 21, se um elemento fizer referência direta à própria coleção, o método insere (this Collection) em vez de chamar recursivamente o método toString() dessa coleção. Este marcador é um pormenor de implementação que a especificação Java SE não garante. As cadeias de caracteres não recebem aspas adicionais, por isso não interpretes o resultado como um formato de serialização.

O exemplo define iterator() e size() numa subclasse anónima que herda toString(). Como a ordem dos dados é fixa, o resultado esperado é [red, null, blue].

Exemplos

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

Resultado

[red, null, blue]

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