Module ContainersLabels.Hashtbl
- since
- 0.14
include module type of Hashtbl with type Hashtbl.statistics = Hashtbl.statistics and module Hashtbl.Make = Hashtbl.Make and type ('a, 'b) Hashtbl.t = ('a, 'b) Hashtbl.t
val create : ?random:bool -> int -> ('a, 'b) t
val clear : ('a, 'b) t -> unit
val reset : ('a, 'b) t -> unit
val copy : ('a, 'b) t -> ('a, 'b) t
val add : ('a, 'b) t -> 'a -> 'b -> unit
val find : ('a, 'b) t -> 'a -> 'b
val find_opt : ('a, 'b) t -> 'a -> 'b option
val find_all : ('a, 'b) t -> 'a -> 'b list
val mem : ('a, 'b) t -> 'a -> bool
val remove : ('a, 'b) t -> 'a -> unit
val replace : ('a, 'b) t -> 'a -> 'b -> unit
val iter : ('a -> 'b -> unit) -> ('a, 'b) t -> unit
val filter_map_inplace : ('a -> 'b -> 'b option) -> ('a, 'b) t -> unit
val fold : ('a -> 'b -> 'c -> 'c) -> ('a, 'b) t -> 'c -> 'c
val length : ('a, 'b) t -> int
val randomize : unit -> unit
val is_randomized : unit -> bool
type statistics
= Hashtbl.statistics
=
{
num_bindings : int;
num_buckets : int;
max_bucket_length : int;
bucket_histogram : int array;
}
val stats : ('a, 'b) t -> statistics
module type HashedType = sig ... end
module type S = sig ... end
module type SeededHashedType = sig ... end
module type SeededS = sig ... end
module MakeSeeded : functor (H : SeededHashedType) -> sig ... end
include CCHashtbl.Poly
val get : ('a, 'b) Hashtbl.t -> 'a -> 'b option
Safe version of
Hashtbl
.find.
val get_or : ('a, 'b) Hashtbl.t -> 'a -> default:'b -> 'b
get_or tbl k ~default
returns the value associated tok
if present, and returnsdefault
otherwise (ifk
doesn't belong intbl
).- since
- 0.16
val keys : ('a, 'b) Hashtbl.t -> 'a CCHashtbl.sequence
Iterate on keys (similar order as
Hashtbl
.iter).
val values : ('a, 'b) Hashtbl.t -> 'b CCHashtbl.sequence
Iterate on values in the table.
val keys_list : ('a, 'b) Hashtbl.t -> 'a list
keys_list t
is the list of keys int
. If the key is in the Hashtable multiple times, all occurrences will be returned.- since
- 0.8
val map_list : ('a -> 'b -> 'c) -> ('a, 'b) Hashtbl.t -> 'c list
Map on a hashtable's items, collect into a list.
val incr : ?by:int -> ('a, int) Hashtbl.t -> 'a -> unit
incr ?by tbl x
increments or initializes the counter associated withx
. Ifget tbl x = None
, then after update,get tbl x = Some 1
; otherwise, ifget tbl x = Some n
, nowget tbl x = Some (n+1)
.- parameter by
if specified, the int value is incremented by
by
rather than 1.
- since
- 0.16
val decr : ?by:int -> ('a, int) Hashtbl.t -> 'a -> unit
Like
incr
but subtract 1 (or the value ofby
). If the value reaches 0, the key is removed from the table. This does nothing if the key is not already present in the table.- since
- 0.16
val to_seq : ('a, 'b) Hashtbl.t -> ('a * 'b) CCHashtbl.sequence
Iterate on bindings in the table.
val add_list : ('a, 'b list) Hashtbl.t -> 'a -> 'b -> unit
add_list tbl x y
addsy
to the listx
is bound to. Ifx
is not bound, it becomes bound toy
.- since
- 0.16
val add_seq : ('a, 'b) Hashtbl.t -> ('a * 'b) CCHashtbl.sequence -> unit
Add the corresponding pairs to the table, using
Hashtbl
.add.- since
- 0.16
val of_seq : ('a * 'b) CCHashtbl.sequence -> ('a, 'b) Hashtbl.t
From the given bindings, added in order.
val add_seq_count : ('a, int) Hashtbl.t -> 'a CCHashtbl.sequence -> unit
add_seq_count tbl seq
increments the count of each element ofseq
by callingincr
. This is useful for counting how many times each element ofseq
occurs.- since
- 0.16
val of_seq_count : 'a CCHashtbl.sequence -> ('a, int) Hashtbl.t
Like
add_seq_count
, but allocates a new table and returns it.- since
- 0.16
val of_list : ('a * 'b) list -> ('a, 'b) Hashtbl.t
Build a table from the given list of bindings
k_i -> v_i
, added in order usingadd
. If a key occurs several times, it will be added several times, and the visible binding will be the last one.
val update : ('a, 'b) Hashtbl.t -> f:('a -> 'b option -> 'b option) -> k:'a -> unit
update tbl ~f ~k
updates keyk
by callingf k (Some v)
ifk
was mapped tov
, orf k None
otherwise; if the call returnsNone
thenk
is removed/stays removed, if the call returnsSome v'
then the bindingk -> v'
is inserted usingHashtbl
.replace.- since
- 0.14
val get_or_add : ('a, 'b) Hashtbl.t -> f:('a -> 'b) -> k:'a -> 'b
get_or_add tbl ~k ~f
finds and returns the binding ofk
intbl
, if it exists. If it does not exist, thenf k
is called to obtain a new bindingv
;k -> v
is added totbl
andv
is returned.- since
- 1.0
val pp : 'a CCHashtbl.printer -> 'b CCHashtbl.printer -> ('a, 'b) Hashtbl.t CCHashtbl.printer
Printer for table. Renamed from
print
since 2.0.- since
- 0.13
module type S' = CCHashtbl.S
module Make' = CCHashtbl.Make