All Manuals > LispWorks User Guide and Reference Manual > 40 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 string designators.

Values

string

A string.

Description

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

Each of the elements of the strings argument is first coerced into a string using the string function if it is 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
See also

string-append*


LispWorks User Guide and Reference Manual - 13 Feb 2015

NextPrevUpTopContentsIndex