LispWorks User Guide and Reference Manual > 34 The LISPWORKS Package

NextPrevUpTopContentsIndex

string-append

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

LispWorks User Guide and Reference Manual - 22 Dec 2009

NextPrevUpTopContentsIndex