Package org.tweetyproject.arg.adf.util

Class UnionSetView<E>

java.lang.Object

java.util.AbstractCollection<E>

org.tweetyproject.arg.adf.util.AbstractUnmodifiableCollection<E>

org.tweetyproject.arg.adf.util.UnionSetView<E>

Type Parameters:

E - the type of elements in this set

All Implemented Interfaces:

Iterable<E>, Collection<E>, Set<E>

public final class UnionSetView<E>
extends AbstractUnmodifiableCollection<E>
implements Set<E>

A view that provides the union of two disjoint sets as a single set. This class does not copy the elements from the sets but merely wraps them. It is expected that the two sets are disjoint, as methods like size() assume that there is no overlap between the elements.

This class provides an unmodifiable view and all modification operations will throw UnsupportedOperationException.

Author:

Mathias Hofer

Constructor Summary

Constructors

Constructor	Description
UnionSetView(Set<? extends E> set1, Set<? extends E> set2)	Expects the two sets to be disjoint, otherwise some methods, e.g.

Method Summary

Modifier and Type	Method	Description
boolean	contains(Object o)
boolean	containsAll(Collection<?> c)
boolean	isEmpty()
Iterator<E>	iterator()
static <E> Set<E>	of(Set<? extends E> set1, Set<? extends E> set2, Set<? extends E> set3)	Creates a UnionSetView that represents the union of three sets.
int	size()
Object[]	toArray()
<T> T[]	toArray(T[] a)

Methods inherited from class org.tweetyproject.arg.adf.util.AbstractUnmodifiableCollection

add, addAll, clear, remove, removeAll, removeIf, retainAll

Methods inherited from class java.util.AbstractCollection

toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Collection

parallelStream, removeIf, stream, toArray

Methods inherited from interface java.lang.Iterable

forEach

Methods inherited from interface java.util.Set

add, addAll, clear, equals, hashCode, remove, removeAll, retainAll, spliterator

Constructor Details

UnionSetView

public UnionSetView(Set<? extends E> set1,
 Set<? extends E> set2)

Expects the two sets to be disjoint, otherwise some methods, e.g. size(), will return unreasonable results.

It is up to the caller to ensure this property, this class performs no additional checks.

Parameters:

set1 - the first set

set2 - the second set

Method Details

of

public static <E> Set<E> of(Set<? extends E> set1,
 Set<? extends E> set2,
 Set<? extends E> set3)

Creates a UnionSetView that represents the union of three sets.

This static method combines the given three sets into a single unified view, where all elements from the three sets appear as one set. It does not create a new set but provides a view representing the union of the specified sets.

Type Parameters:

E - The type of elements contained in the sets.

Parameters:

set1 - The first set to be included in the union.

set2 - The second set to be included in the union.

set3 - The third set to be included in the union.

Returns:

A UnionSetView representing the union of the three sets.

Throws:

NullPointerException - if any of set1, set2, or set3 is null.

size

public int size()

Specified by:

size in interface Collection<E>

Specified by:

size in interface Set<E>

Specified by:

size in class AbstractCollection<E>

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface Collection<E>

Specified by:

isEmpty in interface Set<E>

Overrides:

isEmpty in class AbstractCollection<E>

contains

public boolean contains(Object o)

Specified by:

contains in interface Collection<E>

Specified by:

contains in interface Set<E>

Overrides:

contains in class AbstractCollection<E>

iterator

public Iterator<E> iterator()

Specified by:

iterator in interface Collection<E>

Specified by:

iterator in interface Iterable<E>

Specified by:

iterator in interface Set<E>

Specified by:

iterator in class AbstractCollection<E>

toArray

public Object[] toArray()

Specified by:

toArray in interface Collection<E>

Specified by:

toArray in interface Set<E>

Overrides:

toArray in class AbstractCollection<E>

toArray

public <T> T[] toArray(T[] a)

Specified by:

toArray in interface Collection<E>

Specified by:

toArray in interface Set<E>

Overrides:

toArray in class AbstractCollection<E>

containsAll

public boolean containsAll(Collection<?> c)

Specified by:

containsAll in interface Collection<E>

Specified by:

containsAll in interface Set<E>

Overrides:

containsAll in class AbstractCollection<E>