fwrite_string — Write values in a file.
The operator fwrite_string puts out a string or numbers on the output file defined by the handle FileHandle. The output file must be opened in ASCII format by the operator open_file. The values to be put out on the file are set in the parameter String.
The call set_system(::'flush_file', <boolean-value>:) determines whether the output characters are put out directly on the output medium. If the value 'flush_file' is set to 'false', the characters (especially in case of screen output) show up only after the operator fnew_line is called.
Strings as well as whole numbers and floating point numbers can be used as arguments. If more than one value serves as input, the values are put out consecutively without blanks.
The maximum string length is 1024 character (including the end of string character).
Values to be put out on the file.
Default value: 'hallo'
fwrite_string(FileHandle,['text with numbers:',5,' and ',1.0]) * results in the following output: * 'text with numbers:5 and 1.00000'
If the writing procedure was carried out successfully, the operator fwrite_string returns the value 2 (H_MSG_TRUE). Otherwise, an exception is raised.
open_file, close_file, set_system