## table of contents

- bullseye 1:23.2.6+dfsg-1
- testing 1:24.3.4.1+dfsg-1
- unstable 1:24.3.4.5+dfsg-1
- experimental 1:25.0.4+dfsg-1

sets(3erl) | Erlang Module Definition | sets(3erl) |

# NAME¶

sets - Functions for set manipulation.

# DESCRIPTION¶

Sets are collections of elements with no duplicate elements. The representation of a set is undefined.

This module provides the same interface as the
*ordsets(3erl)* module but with an undefined representation. One
difference is that while this module considers two elements as different if
they do not match (*=:=*), *ordsets* considers two elements as
different if and only if they do not compare equal (*==*).

# DATA TYPES¶

set(Element)

As returned by *new/0*.

set()= set(term())

# EXPORTS¶

add_element(Element, Set1) -> Set2

Types:

Returns a new set formed from *Set1* with *Element*
inserted.

del_element(Element, Set1) -> Set2

Types:

Returns *Set1*, but with *Element* removed.

filter(Pred, Set1) -> Set2

Types:

Set1 = Set2 = set(Element)

Filters elements in *Set1* with boolean function
*Pred*.

fold(Function, Acc0, Set) -> Acc1

Types:

Set = set(Element)

Acc0 = Acc1 = AccIn = AccOut = Acc

Folds *Function* over every element in *Set* and returns
the final value of the accumulator. The evaluation order is undefined.

from_list(List) -> Set

Types:

Set = set(Element)

Returns a set of the elements in *List*.

intersection(SetList) -> Set

Types:

Set = set(Element)

Returns the intersection of the non-empty list of sets.

intersection(Set1, Set2) -> Set3

Types:

Returns the intersection of *Set1* and *Set2*.

is_disjoint(Set1, Set2) -> boolean()

Types:

Returns *true* if *Set1* and *Set2* are disjoint
(have no elements in common), otherwise *false*.

is_element(Element, Set) -> boolean()

Types:

Returns *true* if *Element* is an element of *Set*,
otherwise *false*.

is_empty(Set) -> boolean()

Types:

Returns *true* if *Set* is an empty set, otherwise
*false*.

is_set(Set) -> boolean()

Types:

Returns *true* if *Set* is a set of elements, otherwise
*false*.

is_subset(Set1, Set2) -> boolean()

Types:

Returns *true* when every element of *Set1* is also a
member of *Set2*, otherwise *false*.

new() -> set()

Returns a new empty set.

size(Set) -> integer() >= 0

Types:

Returns the number of elements in *Set*.

subtract(Set1, Set2) -> Set3

Types:

Returns only the elements of *Set1* that are not also
elements of *Set2*.

to_list(Set) -> List

Types:

List = [Element]

Returns the elements of *Set* as a list. The order of the
returned elements is undefined.

union(SetList) -> Set

Types:

Set = set(Element)

Returns the merged (union) set of the list of sets.

union(Set1, Set2) -> Set3

Types:

Returns the merged (union) set of *Set1* and *Set2*.

# SEE ALSO¶

*gb_sets(3erl)*, *ordsets(3erl)*

stdlib 3.14 | Ericsson AB |