Function

Summary

Constructs a single string from a number of strings.

Package

lispworks

Signature

string-append &rest strings => string

Arguments

strings

Any number of strings or string designators.

Values

string

A string.

Description

The string-append function takes any number of string designators and constructs a single string from them.

A string designator is a string, a symbol or a character object.

Each of the elements of the strings argument are first coerced into a string using the string function if they are not already a string.

string is a string of the "widest" type amongst strings . That is, the constructed string is of the same type as the argument with the largest element type.

Example

(readtable-case *readtable*)

=> 

:UPCASE

(string-append "foo" 'bar)

=> 

"fooBAR"

(type-of 

 (string-append 

  (coerce "A" 'simple-base-string)

  (coerce "A" 'simple-text-string)

  ))

=> 

SIMPLE-TEXT-STRING