The string function converts an argument {obj} into a String object. If the argument is a native data type such as: #void, Error, Boolean, Character, Integer, Number, Integer, Money, Percent, Text, or Character, the string function converts the native data type into a String. Complex and String data types are also converted into a String. If the argument is any other heap object such as Symbol, Pair, Vector, Structure, or Dictionary, the string function returns the object's external object id, i.e. #<Vector 1234>. If the optional {true} argument is specified, the string function will attempt to convert the object into the same external display string as the writeln function.


The string function converts a complex number into to a string.


The string function is used to coerce an object into a String or Text. Any character string that is 15 characters is assigned to a Text data type. If a character string containing more than 15 characters is assigned to a String object.


The string function is used for displaying complex numbers.




(string obj)

(string obj true)

Arguments Name Type Description
Argument:objError Void Character String Symbol Vector BitVector ByteVector IntVector FltVector ObjVector Structure Dictionary DirectoryPair Matrix NumMatrix Integer Float Number Complex The object to be coerced
Argument:trueBoolean Optional argument. If present and the obj argument is a heap object, string function will return the object value instead of the object's external id which is converted to a string.


The result string


(string X)

Arguments Name Type Description
Argument:XComplex A complex number.


A string in the standard literal format representing the value of the complex argument.



Here are a number of links to Lambda coding examples which contain this instruction in various use cases.


Argument Types

Here are the links to the data types of the function arguments.

Error Void Character String
Symbol Vector BitVector ByteVector
IntVector FltVector ObjVector Structure
Dictionary Directory Pair Matrix
NumMatrix Integer Float Number

Here are also a number of links to functions having arguments with any of these data types.

++ += + /=
/ *= * --
-= - abs acos
add1 addMethod addi appendWriteln
append apply argument arithmetic
asin associate atan avg
badd balance bdiv binaryInsert
binaryNand binaryNor binaryNot binaryNxor
binarySearch bitToIntegerVector bitToNumberVector bitwiseAnd
bitwiseNand bitwiseNor bitwiseNot bitwiseNxor
bitwiseOr bitwiseShiftLeft bitwiseShiftRight bitwiseXor
bmod bmul boolean cadd
car ccompareEQ ccompareGE ccompareGT
ccompareLE ccompareLT ccompareNE cdiv
cdr char character class
clean closeLog cmod cmul
code compareEQ compareGE compareGT
compareLE compareLT compareNE compare
comparison complex compress conjugate
cons copy cos cosh
count csub date day
days360 debugBrowsableProcs debugDetective debugEval
debug decode defchild defclass
define(macro) defineStructure define defmacro
defmethod deforphan defriend defstruct
defun deg deleteRows delete
dimension disassemble display divi
downcase encode errorTrap error
evalInSyncLocalContext eval exit exp
exportCsv exportSbf exportTab expt
fact fdisplay fieldsOf fileClose
fileCopy fileDir fileDisplay fileEraseDir
fileErase fileExists fileMakeDir fileOpen
fileReadAll fileReadRecord fileRead fileResize
fileSeek fileSizeOf fileWriteAll fileWrite
filewriteln findBlock find floor
fraction freeBlock gc gcd
getGlobalValue getRecursionCount getSymbolTable getTickCount
globalBinding hashString hour iadd
icompareEQ icompareGE icompareGT icompareLE
icompareLT icompareNE idiv imaginary
imod importCsv importSbf importTab
imul insertRows insert inside
inspect integer isAtom isBitVector
isBoolean isBound isByteVector isCharAlphabetic
isCharAlphanumeric isCharLowercase isCharName isCharNumeric
isCharUppercase isCharWhitespace isChar isCharacter
isClass isComplex isDate isDictionary
isDirectory isEqual isError isEven
isExact isFloatVector isIdentical isInexact
isInside isIntegerVector isInteger isLambda
isMatrix isMember isMoney isNegative
isNull isNumberMatrix isNumberVector isNumber
isObjectVector isObject isOdd isPair
isPcodeVector isPositive isString isStructure
isSymbol isText isType isVector
isZero isub julian kurtosis
last lcm left length
list loadModule loadObject loadRepository
loadWorkspace lock log10 log2
log logbase macroReplace makeDictionary
makeGaussianMatrix makeGramMatrix makeQuotedList makeQuotedSymbol
makeStructure map mapc matrixGaussianEliminate
matrixGaussianSubstitute max median member
methodsOf mid min minute
mod modi money month
morph muli nadd ncompareEQ
ncompareGE ncompareGT ncompareLE ncompareLT
ncompareNE ndiv new nmod
nmul now nsub number
objectToDictionary objectToDirectory objectToList objectToMatrix
objectToNumMatrix objectToNumVector objectToStructure objectToVector
offset openLog pair parent
parse pi pointer preAllocateFixedMemoryBlocks
product proplist proprecord putprop
qt rad random randomize
range rank real refAttributes
refValues ref remProp remove
rename replace rept resize
reverse right round run
saveImmediate saveModule saveObject saveRepository
saveWorkspace second send setAttributes
setBlock setCar setCdr setLastCdr
set setf setq sigmoid
sign sin sinh sizeof
skew sleep sort sql
sqrt srandom stdev stdevp
stringCiEQ stringCiGE stringCiGT stringCiLE
stringCiLT stringCiNE stringFill stringToBVector
stringToVector string sub1 subi
submit substitute substringCiEQ substringCiGE
substringCiGT substringCiLE substringCiLT substringCiNE
substringEQ substringFill substringGE substringGT
substringLE substringLT substringNE substring
sum sumsqr super svmRegression
symbolToTypeCode symbol sysError system
tan tanh text time
trim type uncompress uniqueInsert
unlock upcase var varp
vectorBinaryInnerProduct vectorBipolarInnerProduct vectorCosineInnerProduct vectorCubeInnerProduct
vectorDelete vectorExpInnerProduct vectorFill vectorInnerProduct
vectorLogInnerProduct vectorQuartInnerProduct vectorQuintInnerProduct vectorSigmoidInnerProduct
vectorSineInnerProduct vectorSquareInnerProduct vectorTanInnerProduct vectorTanhInnerProduct
writelg writeln year

Analytic Information Server (AIS)

AIS Component Systems

  • Smartbase Engine
  • QT C++ Libraries
  • MySQL Relational Database
  • AIS Lisp Libraries
  • Rapid Analytic Demo IDE