База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

HashSet.add(E) — добавяне на елемент в множество

`HashSet.add(E)` връща `true`, когато добави нов елемент, и `false`, когато множеството вече съдържа равен елемент.

Версия: Java SE 21

Синтаксис

public boolean add(E e)

В Java SE 21 HashSet.add(E) е метод на екземпляр от класа java.util.HashSet<E>. Той приема един елемент e от типа E, определен за елементите на множеството, например String в HashSet<String>.

Ако в множеството няма елемент e2, за който Objects.equals(e, e2) връща true, методът добавя e, увеличава размера с единица и връща true. В противен случай връща false и оставя множеството непроменено: не заменя наличния елемент. HashSet допуска null, затова първото добавяне на null връща true, а следващите опити връщат false, докато null е в множеството.

В собствените си класове съгласувай equals и hashCode: равните обекти трябва да имат еднакъв хеш код, но еднаквият хеш код не означава, че обектите са равни. Не променяй данните, използвани от тези методи, докато обектът е в множеството. HashSet не гарантира реда на обхождане, включително реда на добавяне.

Използвай if (tags.add(tag)), за да изпълниш код само ако елементът е добавен, без първо да извикваш contains. Не всички реализации на Set работят така: множество, създадено с Set.of(...), не може да се променя и извикването на add върху него хвърля UnsupportedOperationException.

Примери

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

Резултат

true
false
true
false
2

`new String("java")` умишлено създава различен обект със същия текст. Второто извикване връща `false`, защото низовете са равни, а не защото са един и същ обект. Накрая множеството съдържа два елемента: `"java"` и `null`.

Свързани уроци

  • Java · Урок 55 · Начално · Версия: 2

Източници