copy ( src i dst -- )
Factor handbook » The language » Collections » Sequence operations » Destructive sequence operations

Prev:	exchange ( m n seq -- )
Next:	When to use destructive operations

Vocabulary
sequences

Inputs

src	a sequence
i	an index in dst
dst	a mutable sequence

Outputs
None

Word description
Copies all elements of src to dst, with destination indices starting from i. Grows dst first if necessary.

Side effects
Modifies dst

Errors
An error is thrown if dst is not resizable, and not large enough to hold the copied elements.

Definition

USING: kernel math sequences.private ;

IN: sequences

: copy ( src i dst -- )
    3dup bounds-check-head [ swap length + ] dip lengthen
    copy-unsafe ; inline