2.6 The COMMON-EXTENSIONS module

concatenate!

Open generic function

Summary

A destructive version of the Dylan language's concatenate; that is, one that might modify its first argument.

Signature

concatenate! sequence #rest more-sequences => result-sequence

Arguments

sequence: An instance of <sequence>.
more-sequences: Instances of <sequence>.

Values

result-sequence: An instance of <sequence>.

Library

common-extensions

Module

common-extensions

Description

A destructive version of the Dylan language's concatenate; that is, one that might modify its first argument.

It returns the concatenation of one or more sequences, in a sequence that may or may not be freshly allocated. If result-sequence is freshly allocated, then, as for concatenate, it is of the type returned by type-for-copy of sequence.

Example

> define variable *x* = "great-"; 
"great-"

> define variable *y* = "abs"; "abs"

> concatenate! (*x*, *y*); 
"great-abs"

> *x*; 
"great-abs" 
>