package commons

  1. Overview
  2. Docs
package commons
Legend:
Page
Library
Module
Module type
Parameter
Class
Class type
Source

Module Map_Source

Association tables over ordered types.

This module implements applicative association tables, also known as finite maps or dictionaries, given a total ordering function over the keys. All operations over maps are purely applicative (no side-effects). The implementation uses balanced binary trees, and therefore searching and insertion take time logarithmic in the size of the map.

The type of the map keys.

Sourcetype ('key, 'a) t

The type of maps from type key to type 'a.

Sourceval empty : ('key, 'a) t

The empty map.

Sourceval is_empty : ('key, 'a) t -> bool

Test whether a map is empty or not.

Sourceval add : 'key -> 'a -> ('key, 'a) t -> ('key, '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.

Sourceval find : 'key -> ('key, 'a) t -> 'a

find x m returns the current binding of x in m, or raises Not_found if no such binding exists.

Sourceval remove : 'key -> ('key, 'a) t -> ('key, 'a) t

remove x m returns a map containing the same bindings as m, except for x which is unbound in the returned map.

Sourceval mem : 'key -> ('key, 'a) t -> bool

mem x m returns true if m contains a binding for x, and false otherwise.

Sourceval iter : ('key -> 'a -> unit) -> ('key, 'a) t -> unit

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 bindings are passed to f in increasing order with respect to the ordering over the type of the keys.

Sourceval map : ('a -> 'b) -> ('key, 'a) t -> ('key, 'b) t

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 bindings are passed to f in increasing order with respect to the ordering over the type of the keys.

Sourceval mapi : ('key -> 'a -> 'b) -> ('key, 'a) t -> ('key, 'b) t

Same as Map.S.map, but the function receives as arguments both the key and the associated value for each binding of the map.

Sourceval fold : ('key -> 'a -> 'b -> 'b) -> ('key, 'a) t -> 'b -> 'b

fold f m a computes (f kN dN ... (f k1 d1 a)...), where k1 ... kN are the keys of all bindings in m (in increasing order), and d1 ... dN are the associated data.

Sourceval of_list : ('key * 'a) list -> ('key, 'a) t
Sourceval to_list : ('key, 'a) t -> ('key * 'a) list
OCaml

Innovation. Community. Security.

GitHub Discord Twitter Peertube RSS
About
Changelog Releases Industrial Users Academic Users Why OCaml
Ecosystem
Packages Community Events OCaml Planet Jobs
Resources
Install OCaml Get Started Platform Tools Language Manual Standard Library API Books Exercises Papers OCaml Playground Logo
Policies
Carbon Footprint Governance Privacy Code of Conduct