CKTIS / Java
HashSet.add(E): añadir un elemento a un conjunto
`HashSet.add(E)` devuelve `true` si inserta un elemento nuevo y `false` si el conjunto ya contiene un elemento igual.
Versión: Java SE 21
Sintaxis
public boolean add(E e)En Java SE 21, HashSet.add(E) es un método de instancia de java.util.HashSet<E>. Recibe un solo elemento e del tipo E del conjunto, por ejemplo, String en HashSet<String>.
Si en el conjunto no hay ningún elemento e2 para el que Objects.equals(e, e2) devuelva true, el método inserta e, aumenta el tamaño en uno y devuelve true. De lo contrario, devuelve false y deja el conjunto intacto: no sustituye el elemento existente. HashSet admite null, así que el primer intento de añadirlo devuelve true; los siguientes devuelven false mientras null siga en el conjunto.
En tus propias clases, asegúrate de que equals y hashCode sean coherentes: los objetos iguales deben tener el mismo código hash, pero compartir código hash no implica que sean iguales. No cambies los datos que usan estos métodos mientras el objeto esté en el conjunto. HashSet no garantiza ningún orden de recorrido, ni siquiera el orden de inserción.
Usa if (tags.add(tag)) para ejecutar código solo si el elemento se ha insertado, sin llamar antes a contains. No todos los Set se comportan así: un conjunto creado con Set.of(...) no se puede modificar, e invocar add en él lanza UnsupportedOperationException.
Ejemplos
import java.util.HashSet;
public class Main {
public static void main(String[] args) {
HashSet<String> tags = new HashSet<>();
System.out.println(tags.add("java"));
System.out.println(tags.add(new String("java")));
System.out.println(tags.add(null));
System.out.println(tags.add(null));
System.out.println(tags.size());
}
}Resultado
true false true false 2
`new String("java")` crea deliberadamente un objeto distinto con el mismo texto. La segunda llamada devuelve `false` porque las cadenas son iguales, no porque sean el mismo objeto. Al final, el conjunto tiene dos elementos: `"java"` y `null`.
Lecciones relacionadas
- Java · Lección 55 · Básico · Versión: 2