Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

Set.add — Añadir un elemento sin duplicados

`Set.add` devuelve `true` si añade el elemento y `false` si ya hay uno equivalente. `HashSet` y `TreeSet` detectan los duplicados de forma distinta.

Versión: Java SE 21

Sintaxis

boolean add(E e);

Set.add es un método de instancia de la interfaz java.util.Set<E>, donde E es el tipo de los elementos. Si el conjunto admite la inserción y acepta el argumento, set.add(element) devuelve true cuando inserta un elemento nuevo. Si ya hay un elemento equivalente, devuelve false: el conjunto no crece y el elemento existente no se sustituye. El valor devuelto indica si hubo una inserción sin necesidad de llamar antes a contains.

El contrato de Set define los duplicados mediante Objects.equals. HashSet usa hashCode y equals: los objetos iguales deben tener el mismo código hash, pero compartir ese código no basta para que sean iguales. Con los métodos generados, dos registros de la misma clase cuyos componentes correspondientes tienen valores iguales son iguales y tienen el mismo código hash. HashSet no garantiza ningún orden de recorrido.

TreeSet se recorre en orden natural o en el orden definido por el Comparator suministrado. Trata los elementos como duplicados cuando compareTo o compare, respectivamente, devuelve 0. El orden debe ser coherente con equals: la comparación debe devolver 0 si y solo si los elementos son iguales según equals. De lo contrario, TreeSet no cumple el contrato general de Set.

La inserción es opcional: un conjunto no modificable creado con Set.of lanza UnsupportedOperationException incluso si el elemento es un duplicado. HashSet admite un elemento null, mientras que un TreeSet con orden natural rechaza null con NullPointerException. Según la implementación, un tipo de argumento incompatible puede provocar ClassCastException, y una propiedad no admitida del elemento puede provocar IllegalArgumentException.

Ejemplos

import java.util.HashSet;
import java.util.Set;
import java.util.TreeSet;

public class Main {
    record Ticket(String name) {}

    public static void main(String[] args) {
        Set<Ticket> tickets = new HashSet<>();
        System.out.println(tickets.add(new Ticket("Ada")));
        System.out.println(tickets.add(new Ticket("Lin")));
        System.out.println(tickets.add(new Ticket("Sam")));
        System.out.println(tickets.add(new Ticket("Ada")));
        System.out.println("Tickets: " + tickets.size());

        Set<Integer> numbers = new TreeSet<>();
        numbers.add(3);
        numbers.add(1);
        numbers.add(2);
        System.out.println("Duplicate 1: " + numbers.add(1));
        System.out.println("TreeSet:");
        for (int number : numbers) {
            System.out.println(number);
        }
    }
}

Resultado

true
true
true
false
Tickets: 3
Duplicate 1: false
TreeSet:
1
2
3

El cuarto `Ticket` es un objeto nuevo, pero es igual al primero, por lo que `add` devuelve `false` y el tamaño sigue siendo `3`. Volver a añadir `1` a `TreeSet` también devuelve `false`, y el recorrido imprime `1`, `2`, `3` en orden natural.

Lecciones relacionadas

  • Java · Lección 5 · Avanzado · Versión: 2
  • Java · Lección 8 · Avanzado · Versión: 2
  • Java · Lección 27 · Básico · Versión: 2
  • Java · Lección 42 · Básico · Versión: 2
  • Java · Lección 4 · Intermedio · Versión: 2
  • Java · Lección 5 · Intermedio · Versión: 2

Fuentes