Element: blob.append ( )

Syntax

<ident> = <blob>.append(<blob2>)

   or

<blob>.append(<blob2>)

Type

blob or procedure

Description

A function which appends the contents of another blob to the blob in question.

If called as part of a blob assignment or expression, the return value of this function is a merge of the blob and another blob (parameter blob2). The original blob is left unchanged.

If called stand-alone, there is no return value but the blob has the contents of blob2 appended to it.

This function has one parameter, blob2, a blob expression yielding the blob to be appended.

The code of this function cannot be redefined.

Examples

Append one blob to another:

myblob.append(yourblob)

Merge 2 blobs, returning the result into a 3rd blob:

blob newblob = myblob.append(yourblob)

See Also