vector-copy! -- r7rs Definition

§

Kind

§

mutator!;

Implemented by

§

• vector-copy! (from vonuvoli);

Procedure signature

§

Procedure variants:

• (((source vector) (source-start range-start) (destination vector)) -> (undefined))
  • inputs:
    • source of type vector;
    • source-start of type range-start;
    • destination of type vector;
  • output: a value of type undefined;
• (((source vector) (source-start range-start) (destination vector) (destination-start range-start)) -> (undefined))
  • inputs:
    • source of type vector;
    • source-start of type range-start;
    • destination of type vector;
    • destination-start of type range-start;
  • output: a value of type undefined;
• (((source vector) (source-start range-start) (destination vector) (destination-start range-start) (destination-end range-end)) -> (undefined))
  • inputs:
    • source of type vector;
    • source-start of type range-start;
    • destination of type vector;
    • destination-start of type range-start;
    • destination-end of type range-end;
  • output: a value of type undefined;

Exports

§

• scheme:base -- (scheme base);

Exports recursive

§

• scheme -- (scheme);

Description

§

(vector-copy! to at from)
(vector-copy! to at from start)
(vector-copy! to at from start end)

Domain: It is an error if at is less than zero or greater than the length of to. It is also an error if (- (vector-length to) at) is less than (- end start).

Copies the elements of vector from between start and end to vector to, starting at at. The order in which elements are copied is unspecified, except that if the source and destination overlap, copying takes place as if the source is first copied into a temporary vector and then into the destination. This can be achieved without allocating storage by making sure to copy in the correct direction in such circumstances.

(define a (vector 1 2 3 4 5))
(define b (vector 10 20 30 40 50))
(vector-copy! b 1 a 0 2)
b  ===>  #(10 1 2 40 50)

---

The text herein was sourced and adapted as described in the "R7RS attribution of various text snippets" appendix.

Referenced-types

§

• vector;
• range-start;
• undefined;
• range-end;