append

 

 

Overview

The append Function appends one or more Vector objects to the end of a target Vector and returns the result. The append operation is non-destructive, that is the result of appending does not change any of the source or target objects. Two Vector objects are concatenated from left to right, returning the final appended Vector. If only one Vector is specified, it is returned.

String

The append Function appends one or more String objects to the end of a target String and returns the result. The append operation is non-destructive, that is the result of appending does not change any of the source or target objects. String objects are concatenated from left to right, returning the final appended String . If only one String is specified, it is returned.

Symbol

The append function appends one or more Symbol objects to the end of a target Symbol: and returns the result. The append operation is non-destructive, that is the result of appending does not change any of the source or target objects. The objects to be appended are concatenated from left to right, returning the result Symbol. If only one Symbol argument is specified, it is returned.

Structure

The append Function appends one or more structure objects to the end of a target structure and returns the result. The append operation is non-destructive, that is the result of appending does not change any of the source or target objects. Two structure objects are concatenated from left to right, returning the final appended structure. If only one structure is specified, it is returned.

Matrix

The append Function appends one or more Matrix objects to the end of a target Matrix and returns the result. The append operation is non-destructive, that is the result of appending does not change any of the source or target objects. Two Matrix objects are concatenated from left to right, returning the final appended Matrix. If only one Matrix is specified, it is returned.

NumMatrix

The append Function appends one or more NumMatrix objects to the end of a target NumMatrix and returns the result. The append operation is non-destructive, that is the result of appending does not change any of the source or target objects. Two NumMatrix objects are concatenated from left to right, returning the final appended NumMatrix. If only one NumMatrix is specified, it is returned.

Pair

The append Function appends one or more Pair objects to the end of a target Pair and returns the result. The append operation is non-destructive, that is the result of appending does not change any of the source or target objects. Two Pair objects are concatenated from left to right, returning the final appended Pair. If only one Pair is specified, it is returned.

Complex

The append function appends a complex number to a string

Usage

Use the append function to concatenate one or more Vectors.

String

Use the append function to concatenate one or more Strings.

Symbol

Use the append function to concatenate one or more Symbols.

Structure

Use the append function to concatenate one or more Structures.

Matrix

Use the append function to concatenate one or more Matrices.

NumMatrix

Use the append function to concatenate one or more NumMatrices.

Pair

Use the append function to concatenate one or more Pairs.

Complex

Use the append function to convert a complex number to a String.

 

Syntax

Expression:

(append vector1 ...)

Arguments Name Type Description
Argument:vector1Vector IntVector NumVector BitVector ShortVector Only one Vector argument is mandatory. It can be followed a list of Vectors, each of which will be concatenated to the first one (non-destructively) and the resulting Vector is returned.

Returns:

If one Vector was passed, the original Vector will be returned. If more than one Vector was passed, the resulting Vector after the append is returned.


Expression:

(append string1 string2 .. )

Arguments Name Type Description
Argument:string1String Only one String argument is mandatory. It can be followed by any number of Strings, each of which will be concatenated to a copy of the first one and the resulting String is returned.

Returns:

If one String was passed, the original String will be returned. If more than one String was passed, the resulting String after the append is returned.


Expression:

(append sym1 sym2 ...)

Arguments Name Type Description
Argument:symbolSymbol Only one Symbol argument is mandatory. It can be followed by a list of Symbols, each of which will be concatenated to a copy of the first one and the resulting Symbol is returned.

Returns:

If one Symbol was passed, the original Symbol will be returned. If more than one Symbol was passed, the resulting Symbol after the append is returned.


Expression:

(append struct1 ...)

Arguments Name Type Description
Argument:struct1Structure Only one structure argument is mandatory. It can be followed a list of structures, each of which will be concatenated to the first one (non-destructively) and the resulting structure is returned.

Returns:

If one Structure was passed, the original Structure will be returned. If more than one Structure was passed, the resulting Structure after the append is returned.


Expression:

(append matrix1 ...)

Arguments Name Type Description
Argument:matrix1Matrix Only one Matrix argument is mandatory. It can be followed by a list of Matrices , each of which will be concatenated to a copy of the first one and the resulting Matrix is returned.

Returns:

If one Matrix was passed, the original Matrix will be returned. If more than one Matrix was passed, the resulting Matrix after the append is returned.


Expression:

(append nummatrix1 ...)

Arguments Name Type Description
Argument:nummatrix1NumMatrix Only one NumMatrix argument is mandatory. It can be followed by a list of NumMatrices , each of which will be concatenated to a copy of the first one and the resulting NumMatrix is returned.

Returns:

If one NumMatrix was passed, the original NumMatrix will be returned. If more than one NumMatrix was passed, the resulting NumMatrix after the append is returned.


Expression:

(append pair1 ...)

Arguments Name Type Description
Argument:pair1Pair Only one Pair argument is mandatory. It can be followed a list of Pairs , each of which will be concatenated to a copy of the first one and the resulting Pair is returned.

Returns:

If one Pair was passed, the original Pair will be returned. If more than one Pair was passed, the resulting Pair after the append is returned.


Expression:

(append X)

Arguments Name Type Description
Argument:XComplex A complex number.

Returns:

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


 

Examples

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.

String Symbol Structure Vector
Matrix NumMatrix Pair BitVector
CpxVector FltVector IntVector NumVector
ObjVector ShortVector

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

++ += /= *=
-- -= addMethod appendWriteln
append apply associate balance
binaryInsert binarySearch bitToIntegerVector bitToNumberVector
boolean car cdr character
class clean closeLog code
compareEQ compareGE compareGT compareLE
compareLT compareNE compare comparison
compress cons copy count
date day days360 debugBrowsableProcs
debugDetective debugEval debug defchild
defclass define(macro) defineStructure define
defmacro defmethod deforphan defriend
defstruct defun delete dimension
disassemble display downcase encode
evalInSyncLocalContext eval exportCsv exportSbf
exportTab fieldsOf fileDir fileEraseDir
fileExists fileMakeDir fileReadAll fileReadRecord
fileSizeOf fileWriteAll findBlock find
freeBlock gc getGlobalValue getSymbolTable
globalBinding hashString hour importCsv
importSbf importTab 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 isFloatVector
isIdentical isInside isIntegerVector isInteger
isLambda isMatrix isMember isMoney
isNumberMatrix isNumberVector isNumber isObjectVector
isObject isPair isPcodeVector isString
isStructure isSymbol isText isType
isVector julian last left
length list loadModule loadWorkspace
lock macroReplace makeGaussianMatrix makeGramMatrix
makeQuotedList makeQuotedSymbol makeStructure map
mapc matrixGaussianEliminate matrixGaussianSubstitute member
methodsOf mid minute money
month morph new number
objectToList objectToMatrix objectToNumMatrix objectToNumVector
objectToStructure objectToVector offset openLog
pair parent parse pointer
product proplist proprecord putprop
qt rank refAttributes refValues
ref remProp remove rename
replace rept resize reverse
right run saveImmediate saveModule
saveObject saveRepository saveWorkspace second
send setAttributes setBlock setCar
setCdr setLastCdr set setf
setq sizeof sort sql
stringCiEQ stringCiGE stringCiGT stringCiLE
stringCiLT stringCiNE stringFill stringToBVector
stringToVector string submit substitute
substringCiEQ substringCiGE substringCiGT substringCiLE
substringCiLT substringCiNE substringEQ substringFill
substringGE substringGT substringLE substringLT
substringNE substring super svmRegression
symbolToTypeCode symbol system text
time trim type uniqueInsert
unlock upcase vectorBinaryInnerProduct vectorBipolarInnerProduct
vectorCosineInnerProduct vectorCubeInnerProduct 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