file.write
Writes a character data string to a file
Usage
file.write [-a] [-l] <filename:string> <data:string>
Description
Writes <data> (which is a string of characters) to the file <filename>.
It does not append a trailing LF character: if you want it you must explicitly specify it in the <data> parameter.

-a causes the command to append the <data> to the file instead of overwriting the entire file.

The path is adjusted according to the system that KVIrc is running on so you don't have to bother about portability: it should be automatically guaranteed - just use a UNIX style path.

The file is saved in UTF-8 unless the -l switch is specified (in that case the local 8-bit encoding is used). Please note that UTF-8 is the only character set that preserves ALL the possible characters with the exception of the null terminator.

If you want to write binary data, take a look at file.writebytes instead.
Switches
-a | --append
If the file already exists, append the data instead of overwriting the original contents.
-l | --local-8-bit
Causes the file to be written in the local 8-bit character set instead of the default UTF-8.
See also
file.rename, $file.exists

Index, Commands