srfi.43 - Vector library (legacy) ¶This module is effectively superseded by R7RS and SRFI-133. There are a few procedures that are not compatible with R7RS and SRFI-133, and this module remains to support legacy code that depends on them.
See Vectors, and see scheme.vector - R7RS vectors, for the “modern” versions
of vector library. New code should use them.
The following procedures in SRFI-43 are built-in. See Vectors, for the description.
make-vector vector vector? vector-ref vector-set! vector-length vector-fill! vector-copy vector-copy! vector-append vector->list list->vector reverse-list->vector
The following procedures in SRFI-43 are supported by SRFI-133.
See scheme.vector - R7RS vectors, for the description.
vector-unfold vector-unfold-right vector-reverse-copy vector-reverse-copy! vector-concatenate vector-empty? vector= vector-index vector-index-right vector-skip vector-skip-right vector-binary-search vector-any vector-every vector-swap! reverse-vector->list
We explain the procedures that are not listed above.
[SRFI-43]{srfi.43}
Like vector-fold and vector-fold-right
in SRFI-133, but kons
takes an extra argument, the current index, as its first argument.
So kons must accept n+2 arguments, where
n is the number of given vectors.
It is called as (kons <index> <cumulated-value> <elt1> <elt2> ...).
Gauche has fold-with-index (see Mapping over sequences)
that can be used to fold vectors with index, but the argument order
of kons is slightly different: It passes the index, each
element from argument vectors, then cumulated values.
(use srfi.43) (vector-fold list '() '#(a b c) '#(d e f)) ⇒ (2 (1 (0 () a d) b e) c f) (use gauche.sequence) (fold-with-index list '() '#(a b c) '#(d e f)) ⇒ (2 c f (1 b e (0 a d ())))
[SRFI-43]{srfi.43}
Like vector-map and vector-for-each of R7RS,
and vector-map! and vector-count in srfi-133,
except f takes
an extra argument, the current index, as its first argument.
Gauche provides vector-map-with-index,
vector-map-with-index! and vector-for-each-with-index
which are the same as SRFI-43’s vector-map, vector-map!
and vector-for-each, respectively. See Vectors.
(vector-map list '#(a b c)) ⇒ #((0 a) (1 b) (2 c)) (vector-map list '#(a b c) '#(d e f g)) ⇒ #((0 a d) (1 b e) (2 c f)) (vector-count = '#(0 2 2 4 4)) ⇒ 3
(Note: The vector-count example calls = with
two arguments, the current index and the element, for each element
of the input vector. So it counts the number of
occasions when the element is equal to the index.)
The generic map and for-each
in gauche.collection can be used
on vectors, but the mapped procedure is called without index, and the result
is returned as a list.
(vector-map f vec1 vec2 …) is operationally equivalent to
(map-to-with-index <vector> f vec1 vec2 …).
See gauche.collection - Collection framework and gauche.sequence - Sequence framework.