Previous Up Next

5.14  Module Map

Module type OrderedType
Input signature of the functor Map.Make.
module type OrderedType = sig

type (#'a:level) t
The type of the map keys.

val compare : 'a t -> 'a t -> 'a int
A total ordering function over the keys. This is a two-argument function f such that f e1 e2 is zero if the keys e1 and e2 are equal, f e1 e2 is strictly negative if e1 is smaller than e2, and f e1 e2 is strictly positive if e1 is greater than e2. Example: a suitable ordering function is the generic structural comparison function Pervasives.compare.

end

Module type S
Output signature of the functor Map.Make.
module type S = sig

type (#'a:level) key
The type of the map keys.

type (+'a:type, #'b:level) t
The type of maps from type key to type 'a.

val empty : ('a, 'b) t
The empty map.

val add : 'a key -> 'b -> ('b, 'a) t -> ('b, 'a) t
add x y m returns a map containing the same bindings as m, plus a binding of x to y. If x was already bound in m, its previous binding disappears.

val find : 'a key -> ('b, 'a) t -{'c | Not_found: 'c |}-> 'b
           with 'a < level('b), 'c
find x m returns the current binding of x in m, or raises Not_found if no such binding exists.

val remove : 'a key -> ('b, 'a) t -> ('b, 'a) t
remove x m returns a map containing the same bindings as m, except for x which is unbound in the returned map.

val mem : 'a key -> ('b, 'a) t -> 'a bool
mem x m returns true if m contains a binding for x, and false otherwise.

val iter : ('a key -{'b | 'c | 'd}-> 'e -{'f | 'c | 'f}-> 'g) ->
           ('e, 'a) t -{'d | 'c |}-> unit
           with 'a, content('c), 'd < 'f
           and  'a, content('c), 'd < 'b
iter f m applies f to all bindings in map m. f receives the key as first argument, and the associated value as second argument. The order in which the bindings are passed to f is unspecified. Only current bindings are presented to f: bindings hidden by more recent bindings are not passed to f.

val map : ('a -{'b | 'c | 'd}-> 'e) -> ('a, 'f) t -{'b | 'c |}-> ('e, 'f) t
          with content('c), 'd, 'f < 'b
          and  'd < level('e)
map f m returns a map with same domain as m, where the associated value a of all bindings of m has been replaced by the result of the application of f to a. The order in which the associated values are passed to f is unspecified.

val mapi : ('a key -{'b | 'c | 'd}-> 'e -{'f | 'g | 'h}-> 'i) ->
           ('e, 'a) t -{'j | 'g |}-> ('i, 'a) t
           with 'a, content('c), 'd, content('g), 'h, 'j < 'f
           and  'a, content('c), 'd, content('g), 'j < 'b
           and  'c < 'g
           and  'd, 'h < level('i)
Same as Map.S.map, but the function receives as arguments both the key and the associated value for each binding of the map.

val fold : ('a key -{'b | 'c | 'd}->
            'e -{'f | 'c | 'g}-> 'h -{'i | 'c | 'j}-> 'k) ->
           ('e, 'a) t -> 'k -{'l | 'c |}-> 'k
           with 'a, content('c), 'd, 'g, 'j, 'l < 'i
           and  'a, content('c), 'd, 'g, 'l < 'f
           and  'a, content('c), 'd, 'l < 'b
           and  'a, 'd, 'g, 'j < level('h)
           and  'k < 'h
           and  'a, 'd, 'g, 'j < level('k)
fold f m a computes (f kN dN ... (f k1 d1 a)...), where k1 ... kN are the keys of all bindings in m, and d1 ... dN are the associated data. The order in which the bindings are presented to f is unspecified.

end

module Make : functor (Ord : OrderedType) -> S with type 'a key = 'a Ord.t
Functor building an implementation of the map structure given a totally ordered type.


Previous Up Next