append

Format: append( data, file )

Arguments: [any] data Any numeric or text value, including lists

(text) file Name of the file to write

Returns: [any] The value of data

Description: The value of data is written to file. If file already exists, data is appended to the end of file. Otherwise, file is created.

If data is a numeric value, it is translated into a text string as it would be displayed. If data is a list, all elements in the list are written including a comma separating each element. A new line character (\n) is not automatically inserted between append operations.

If file does not contain full path information, the file is assumed to reside in the same directory as the .mdl or .dsb application file. If you include path information, remember that backslash characters must be typed twice in text literals (e.g., "c:\\temp.txt" instead of "c:\temp.txt").

Examples: write("Text","temp.txt") = Text  (creates the file temp.txt)

append(2+3,"temp.txt") = 5  (appends 5 to temp.txt)

read("temp.txt") = Text5

See Also: appendcsv, appendtxt, write, read