suve

awful: function: f-writeln

Available since rev.39 (v.0.5.3).

Declaration

string :f-writeln ( file $FILE, mixed $… )

Summary

Takes any number of arguments and writes them to FILE, in a left-to-right order, followed by a newline. Arrays and dictionaries are printed the same way as if they were converted to a string - array(size) or dict(size). Contrary to string-casting, literal NIL values will be printed as {NIL}.

Value returned is always an empty string. Newline encoding is platform-dependent.
The file should be either in append or rewrite mode. Otherwise, the function will silently fail.

Example

# :f-writeln example
:set &f :f-rewrite s'example.txt'
:f-writeln $f s'Current time: ' :dt-str
:f-close $f

wikipage modified on 2014/0609/2238