string-append - append strings
(import (rnrs)) ;R6RS
(import (rnrs base)) ;R6RS
(import (scheme r5rs)) ;R7RS
(import (scheme base)) ;R7RS
(string-append string ...)
Returns a newly allocated string whose characters form the concatenation of the
given strings.
Some implementations have a single empty string object; see
make-string(3scm).
Returns a single value; a string.
(string-append "Hello," " " "world!") => "Hello, world!"
(string-append) => ""
Applications should not use this in a loop to accumulate output. Use
open-string-output-port(3scm) instead.
This procedure works the same in all RnRS revisions. The only difference between
implementations is whether the empty string is newly allocated or not (see
above).
This procedure can raise exceptions with the following condition types:
- &assertion (R6RS)
- An argument was outside its domain.
- R7RS
- The assertions described above are errors. Implementations may signal an
error, extend the procedure's domain of definition to include such
arguments, or fail catastrophically.
append(3scm), open-string-output-port(3scm)
R4RS, IEEE Scheme, R5RS, R6RS, R7RS
This procedure first appeared in R2RS.