fwrite_nl_string ( : : String : )

Output of values on a text file with additional new lines.

The operator fwrite_nl_string puts out a string or numbers on the current input file. After every tuple element a new line is addent. So there will be as much lines as elements in the tuple. Before opening the first file the standard output ('standard_output') is used. Via the operator set_file('standard_output') one can switch back to the standard output at any time. The operator open_file opens a file. The operator set_file activates a file. The call set_system(::'flush_file', <Wahrheitswert>:) 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.


Parameters

String (input_control)
string(-array) -> string / integer / real
Values to be put out on the text file.
Default value: 'hallo'


Example
fwrite_nl_string(::['text with numbers:',5,'and',1.0]:).
/* results in the following output:       */
/*    'text with numbers:'                */
/*    '5'                                 */
/*    'and'                               */
/*    '1.00000'                           */

Result

If a file is activated and the writing procedure was carried out successfully the operator fwrite_nl_string returns the value TRUE. Otherwise an exception is raised.


Possible Predecessors

open_file, set_file


Possible Successors

close_file


Alternatives

fwrite_string, write_string


See also

open_file, close_file, get_file, set_file, set_system



Copyright © 1996-1997 MVTec Software GmbH