VCollections.src.org.violetlib.collections.impl.SetBuilderImpl Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of vcollections Show documentation

Java Immutable Collections

The newest version!

/*
 * Copyright (c) 2023 Alan Snyder.
 * All rights reserved.
 *
 * You may not use, copy or modify this file, except in compliance with the license agreement. For details see
 * accompanying license terms.
 */

package org.violetlib.collections.impl;

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

import org.violetlib.collections.ISet;
import org.violetlib.collections.SetBuilder;

import org.jetbrains.annotations.*;

/**
  A builder of sets.

  @param  The type of the set elements.
*/

public final class SetBuilderImpl
  implements SetBuilder
{
    public static  @NotNull SetBuilder create()
    {
        return new SetBuilderImpl<>();
    }

    private final @NotNull Set elements;

    private SetBuilderImpl()
    {
        elements = new HashSet<>();
    }

    /**
      Remove all elements.
    */

    @Override
    public void reset()
    {
        elements.clear();
    }

    /**
      Add an element to the current set of elements.
      @param element The element to be added.
    */

    @Override
    public void add(@NotNull V element)
    {
        // safety check
        if (element == null) {
            throw new IllegalArgumentException("Element must not be null");
        }

        elements.add(element);
    }

    @Override
    public boolean isEmpty()
    {
        return elements.isEmpty();
    }

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

    /**
      Return an immutable set containing the current elements.
      @return the set.
    */

    @Override
    public @NotNull ISet values()
    {
        return SimpleSet.fromSet(elements);
    }
}