package gen

  1. Overview
  2. Docs
Iterators for OCaml, both restartable and consumable

Install 

dune-project
 Dependency

github.com Readme Changelog Edit opam file Versions (7)

Authors

  1. S
    Simon Cruanes
  2. E
    ELLIOTTCABLE

Maintainers

  1. S
    simon.cruanes.2007@m4x.org

Sources

0.5.2.tar.gz
md5=dd731ef527022ea698955db687e6cb5f
sha512=c84e5ea0c9b3a678b6a5c935eacf91265a79b68a48375c44aa5f159d4cb02283c1be0786e172a153666c670bc7ee37b931004b8747a99e5f4ab90ca63e097ff5

doc/gen/GenMList/index.html

Module GenMList

Efficient Mutable Lists

Unrolled lists, append-only, used for storing the content of a generator.

Example:

  let g = 1 -- 1000 ;;
  val g : int t = <fun>

  let c = g |> MList.of_gen_lazy |> MList.to_clonable;;
  val c : int clonable = <obj>

            c#next |> take 500 |> to_list;;
  - : int list = [1; 2; 3; .....; 500]

  let c' = c#clone ;;
  val c' : int clonable = <obj>

             c |> to_list;;
  - : int list = [501; 502; ....; 1000]

    c'#gen |> to_list;;   (* c consumed, but not c' *)
  - : int list = [501; 502; ....; 1000]

    c#gen |> to_list;;
  - : int list = []
  • since 0.2.3
type 'a gen = unit -> 'a option
type 'a clonable = < gen : 'a gen ; clone : 'a clonable >
type 'a t

An internal append-only storage of elements of type 'a, produced from a generator

val of_gen : 'a gen -> 'a t

of_gen g consumes g to build a mlist

val of_gen_lazy : ?max_chunk_size:int -> ?caching:bool -> 'a gen -> 'a t

of_gen_lazy g makes a mlist that will read from g as required, until g is exhausted. Do not use g directly after this, or some elements will be absent from the mlist!

  • parameter caching

    if true or absent, values are read from the generator by chunks of increasing size. If false, values are read one by one.

  • parameter max_chunk_size

    if provided and caching = true, sets the (maximal) size of the internal chunks

val to_gen : 'a t -> 'a gen

Iterate on the mlist. This function can be called many times without any problem, the mlist isn't consumable!

val to_clonable : 'a t -> 'a clonable