Append document
Append document ( document {; fileType} ) : Time
| 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 | Time | ← | 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
Properties
| Command number | 265 |
| Thread safe | ✓ |
| Modifies variables | OK, Document, error |