simon/iter
1
0
Fork 0
mirror of https://github.com/c-cube/iter.git synced 2025-12-06 03:05:29 -05:00
Code Issues Projects Releases Packages Wiki Activity Actions

Add seeding section with example

Browse source
This commit is contained in:
Ryan M. Moore 2023-05-03 18:34:24 -04:00
parent 8322b2b201
commit b65be73022
2 changed files with 44 additions and 8 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

26
src/Iter.mli
View file

@ -705,11 +705,9 @@ module Map : sig
module Make (V : Map.OrderedType) : S with type key = V.t
end
(** {1 Random iterators}
(** {1 Random iterators} *)
Random iterators use [Random.int], [Random.float], [Random.bool],
etc., under the hood, so they will respect seeding of the random
generator in the usual way. *)
(** {2 Generating} *)
val random_int : int -> int t
(** Infinite iterator of random integers between 0 and
@ -749,6 +747,26 @@ val sample : int -> 'a t -> 'a array
It returns an array of size [min (length seq) n].
@since 0.7 *)
(** {2 Seeding}
Random iterators use [Random.int], [Random.float], [Random.bool],
etc., under the hood, so they will respect seeding of the random
generator in the usual way. I.e., if you do not initialize the
random generator with one of [Random.init], [Random.full_init], or
[Random.self_init] before calling these functions, they will yield
the same values across seperate invocations of your program.
Example:
{[
(* Ensure a fresh random seed each time the program is executed. *)
let () = Random.self_init ()
(* Generate random values. *)
let l = Iter.random_int 1000 |> Iter.take 3 |> Iter.to_list
]}
*)
(** {1 Infix functions} *)
module Infix : sig

26
src/IterLabels.mli
View file

@ -674,11 +674,9 @@ module Map : sig
module Make (V : Map.OrderedType) : S with type key = V.t
end
(** {2 Random iterators}
(** {2 Random iterators} *)
Random iterators use [Random.int], [Random.float], [Random.bool],
etc., under the hood, so they will respect seeding of the random
generator in the usual way. *)
(** {3 Generating} *)
val random_int : int -> int t
(** Infinite iterator of random integers between 0 and
@ -718,6 +716,26 @@ val sample : n:int -> 'a t -> 'a array
It returns an array of size [min (length seq) n].
@since 0.7 *)
(** {3 Seeding}
Random iterators use [Random.int], [Random.float], [Random.bool],
etc., under the hood, so they will respect seeding of the random
generator in the usual way. I.e., if you do not initialize the
random generator with one of [Random.init], [Random.full_init], or
[Random.self_init] before calling these functions, they will yield
the same values across seperate invocations of your program.
Example:
{[
(* Ensure a fresh random seed each time the program is executed. *)
let () = Random.self_init ()
(* Generate random values. *)
let l = Iter.random_int 1000 |> Iter.take 3 |> Iter.to_list
]}
*)
(** {2 Infix functions} *)
module Infix : sig