Module `CCFQueue`Source

Functional queues

Sourcetype 'a iter = ('a -> unit) -> unit

Sourcetype 'a equal = 'a -> 'a -> bool

Sourcetype 'a printer = Format.formatter -> 'a -> unit

Basics

Sourcetype +'a t

Queue containing elements of type 'a

Sourceval empty : 'a t

Sourceval is_empty : 'a t -> bool

Sourceval singleton : 'a -> 'a t

Sourceval doubleton : 'a -> 'a -> 'a t

Sourceexception Empty

Sourceval cons : 'a -> 'a t -> 'a t

Push element at the front of the queue.

Sourceval snoc : 'a t -> 'a -> 'a t

Push element at the end of the queue.

Sourceval take_front : 'a t -> ('a * 'a t) option

Get and remove the first element.

Sourceval take_front_exn : 'a t -> 'a * 'a t

Same as take_front, but fails on empty queues.

raises Empty
if the queue is empty.

Sourceval take_front_l : int -> 'a t -> 'a list * 'a t

take_front_l n q takes at most n elements from the front of q, and returns them wrapped in a list.

raises Invalid_argument
if n<0.

Sourceval take_front_while : ('a -> bool) -> 'a t -> 'a list * 'a t

Sourceval take_back : 'a t -> ('a t * 'a) option

Take last element.

Sourceval take_back_exn : 'a t -> 'a t * 'a

Same as take_back, but fails on empty queues.

raises Empty
if the queue is empty.

Sourceval take_back_l : int -> 'a t -> 'a t * 'a list

take_back_l n q removes and returns the last n elements of q. The elements are in the order of the queue, that is, the head of the returned list is the first element to appear via take_front. take_back_l 2 (of_list [1;2;3;4]) = of_list [1;2], [3;4].

raises Invalid_argument
if n<0.

Sourceval take_back_while : ('a -> bool) -> 'a t -> 'a t * 'a list

Individual extraction

Sourceval first : 'a t -> 'a option

First element of the queue.

Sourceval last : 'a t -> 'a option

Last element of the queue.

Sourceval first_exn : 'a t -> 'a

Same as first but

raises Empty
if the queue is empty.

Sourceval last_exn : 'a t -> 'a

Sourceval nth : int -> 'a t -> 'a option

Return the i-th element of the queue in logarithmic time.

Sourceval nth_exn : int -> 'a t -> 'a

Unsafe version of nth.

raises Not_found
if the index is wrong.

Sourceval tail : 'a t -> 'a t

Queue deprived of its first element. Does nothing on empty queues.

Sourceval init : 'a t -> 'a t

Queue deprived of its last element. Does nothing on empty queues.

Global Operations

Sourceval append : 'a t -> 'a t -> 'a t

Append two queues. Elements from the second one come after elements of the first one. Linear in the size of the second queue.

Sourceval rev : 'a t -> 'a t

Reverse the queue, O(n) complexity.

since 0.10

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

Map values.

Sourceval (>|=) : 'a t -> ('a -> 'b) -> 'b t

Synonym to map.

Sourceval size : 'a t -> int

Number of elements in the queue (constant time).

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

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

Sourceval equal : 'a equal -> 'a t equal

Conversions

Sourceval of_list : 'a list -> 'a t

Sourceval to_list : 'a t -> 'a list

Sourceval add_iter_front : 'a iter -> 'a t -> 'a t

since 3.0

Sourceval add_iter_back : 'a t -> 'a iter -> 'a t

since 3.0

Sourceval to_iter : 'a t -> 'a iter

since 3.0

Sourceval of_iter : 'a iter -> 'a t

since 3.0

Sourceval add_seq_front : 'a Seq.t -> 'a t -> 'a t

since 3.0

Sourceval add_seq_back : 'a t -> 'a Seq.t -> 'a t

since 3.0

Sourceval to_seq : 'a t -> 'a Seq.t

since 3.0

Sourceval of_seq : 'a Seq.t -> 'a t

since 3.0

Sourceval (--) : int -> int -> int t

a -- b is the integer range from a to b, both included.

since 0.10

Sourceval (--^) : int -> int -> int t

a -- b is the integer range from a to b, where b is excluded.

since 0.17

Sourceval pp : 'a printer -> 'a t printer

since 0.13

Install

Dune Dependency

Authors

Maintainers

Sources

doc/containers-data/CCFQueue/index.html

Module `CCFQueue`Source

Basics

Individual extraction

Global Operations

Conversions

package containers-data

Install

Dune Dependency

Authors

Maintainers

Sources

doc/containers-data/CCFQueue/index.html

Module CCFQueueSource

Basics

Individual extraction

Global Operations

Conversions

Module `CCFQueue`Source