package smtml
Module Expr_raw.SetSource
The set type
Basic functions
mem elt set is true if elt is contained in set, O(log(n)) complexity.
add elt set adds element elt to the set. Preserves physical equality if elt was already present. O(log(n)) complexity.
cardinal set is the size of the set (number of elements), O(n) complexity.
is_singleton set is Some (Any elt) if set is singleton elt and None otherwise.
remove elt set returns a set containing all elements of set except elt. Returns a value physically equal to set if elt is not present.
The minimal element (according to the unsigned order on to_int) if non empty. raises Not_found
The maximal element (according to the unsigned order on to_int) if non empty. raises Not_found
pop_unsigned_minimum s is Some (elt, s') where elt = unsigned_min_elt s and s' = remove elt s if s is non empty. Uses the unsigned order on to_int.
pop_unsigned_maximum s is Some (elt, s') where elt = unsigned_max_elt s and s' = remove elt s if s is non empty. Uses the unsigned order on to_int.
Iterators
iter f set calls f on all elements of set, in the unsigned order of to_int.
filter f set is the subset of set that only contains the elements that satisfy f. f is called in the unsigned order of to_int.
for_all f set is true if f is true on all elements of set. Short-circuits on first false. f is called in the unsigned order of to_int.
fold f set acc returns f elt_n (... (f elt_1 acc) ...), where elt_1, ..., elt_n are the elements of set, in increasing unsigned order of to_int
split elt set returns s_lt, present, s_gt where s_lt contains all elements of set smaller than elt, s_gt all those greater than elt, and present is true if elt is in set. Uses the unsigned order on to_int.
Functions on pairs of sets
union a b is the set union of a and b, i.e. the set containing all elements that are either in a or b.
inter a b is the set intersection of a and b, i.e. the set containing all elements that are in both a or b.
min_elt_inter s1 s2 is unsigned_min_elt of inter s1 s2, but faster as it does not require computing the whole intersection. Returns None when the intersection is empty.
max_elt_inter s1 s2 is unsigned_max_elt of inter s1 s2, but faster as it does not require computing the whole intersection. Returns None when the intersection is empty.
Conversion functions
to_seq st iterates the whole set, in increasing unsigned order of to_int
to_rev_seq st iterates the whole set, in decreasing unsigned order of to_int
add_seq s st adds all elements of the sequence s to st in order.
of_seq s creates a new set from the elements of s.
to_list s returns the elements of s as a list, in increasing unsigned order of to_int