Append document

Append document ( document {; fileType} ) : DocRef

Parameter	Type		Description
document	Text	→	Document name or Full document pathname or Empty string for standard file dialog box
fileType	Text	→	List of types of documents to be screened, or "*" to not screen the documents
Function result	DocRef	←	Document reference number

Description

The Append document command does the same as thing as Open document: it opens a document on disk.

The only difference is that Append document sets the file position at the end of the document while Open document sets its at the beginning of the document.

Refer to Open document for more details about using Append document.

Example

The following example opens an existing document called Note, appends the string "and so long" and a carriage return onto the end of the document, and closes the document. If the document already contained the string "Good-bye", the document would now contain the string “Good-bye and so long”, followed by a carriage return:

 var vhDocRef : Time
 vhDocRef:=Append document("Note.txt") //Open Note document
 SEND PACKET(vhDocRef;" and so long"+Char(13)) //Append a string
 CLOSE DOCUMENT(vhDocRef) //Close the document

See also

Create document
Open document

Properties

Command number	265
Thread safe	✓
Modifies variables	OK, Document, error