.VectorScript|VectorScript ..VS:Function Reference|Function Reference ..VS:Function_Reference_Appendix|Appendix
DescriptionProcedure WriteLn outputs the specified data to an ASCII text file. The variable length parameter list specifies the data to be written to the file.
Parameters may be any valid data type, and data types may be mixed in a single call to the procedure. A carriage return is appended to the end of the line of data, so that the file pointer is at the beginning of a new line in the file, and any data written to the file after the procedure call will be on the new line.
See the VectorScript Language Guide for details on formatting values using WriteLn.
RemarksFrom Raymond Mullin:
1 - Writing NUL (chr(0)) is impossible. Nothing happens.
2 - Writing LF changes the value to CR (LineFeed -> CarriageReturn, or 0A -> 0D hex).
3 - Reading LF & CR (0A & 0D hex) returns the SPACE character (20 hex).
4 - String variables cannot contain NUL characters as the NUL is used to delimit the end of the string (thanks Pat).
5 - An array of characters can have NUL as one or more of its elements.
6 - Writing the array to a file will fail to export the NUL values.
7 - If an array of characters is written to a file, the number of characters in the file will be less than the array length by the number of NULS in the array.
PROCEDURE Example; CONST Vendor = 'ACME'; Price = 123.45; Tax = 1.07; BEGIN ReWrite('Output.txt'); WriteLn('Mfr/Cost: ', Vendor, '/', Price + Tax); Close('Output.txt'); END; RUN(Example);