package octez-libs
Install
Dune Dependency
Authors
Maintainers
Sources
sha256=c6df840ebbf115e454db949028c595bec558a59a66cade73b52a6d099d6fa4d4
sha512=d8aee903b9fe130d73176bc8ec38b78c9ff65317da3cb4f3415f09af0c625b4384e7498201fdb61aa39086a7d5d409d0ab3423f9bc3ab989a680cf444a79bc13
doc/octez-libs.stdlib/Tezos_stdlib/FallbackArray/index.html
Module Tezos_stdlib.FallbackArray
Source
This module implements arrays equipped with accessors that cannot raise exceptions. Reading out of the bounds of the arrays return a fallback value fixed at array construction time, writing out of the bounds of the arrays is ignored.
The type for array containing values of type 'a
.
make len v
builds an array a
initialized len
cells with v
. The value v
is the fallback value for a
.
of_list ~fallback ~proj l
builds a fallback array a
of length List.length l
where each cell i
is initialized by proj (List.nth l i)
and the fallback value is fallback
.
get a idx
returns the contents of the cell of index idx
in a
. If idx
< 0 or idx
>= length a
, get a idx
= fallback a
.
set a idx value
updates the cell of index idx
with value
. If idx
< 0 or idx
>= length a
, a
is unchanged.
iter f a
iterates f
over the cells of a
from the cell indexed 0
to the cell indexed length a - 1
.
map f a
computes a new array obtained by applying f
to each cell contents of a
. Notice that the fallback value of the new array is f (fallback a)
.
fold f a init
traverses a
from the cell indexed 0
to the cell indexed length a - 1
and transforms accu
into f accu x
where x
is the content of the cell under focus. accu
is init
on the first iteration.
fold_map f a init fallback
traverses a
from the cell indexed 0
to the cell indexed length a - 1
and transforms accu
into fst (f accu x)
where x
is the content of the cell under focus. accu
is init
on the first iteration. The function also returns a fresh array containing snd (f accu x)
for each x
. fallback
is required to initialize a fresh array before it can be filled.