Element: blob.appendfile ( )

Syntax

<blob>.appendfile({<file>})

Type

procedure

Description

A function to save the blob contents to file, appending to the end of the file if it already exists. A zero value is returned when successful. 1 is returned on error.

The parameter to this procedure is the name of the file to which the blob contents are to be dumped. If the parameter is omitted, the value of blob.file is used.

It is not permitted to save the contents of a mapped-file blob to itself (see fileblob), since the blob already reflects the contents of the file.

The code of the function cannot be redefined.

See Also