Write on the file indicated as first argument the data (chars) of the stream indicated as second argument. Allows to convert streams of an encoding to another one. It means that the encoding of both arguments can be indicated (file and stream to write).

# 1 file.chars.write

<file.chars.write    append='true|false'    encoding-src='encoding-src'    encoding-src='encoding-src'/>
Example

Write in a file an origin stream.

Copy
<xsql-script name='file_chars_write_sample'>
<body>
<set name='m_file'>
<string>c:<file.separator />source<file.separator />deister.txt</string>
</set>
<file.chars.write append='true' encoding-src='ISO-8859-1' encoding-dst='ISO-8859-1'>
<file name='#m_file' type='absolute' />
<string>This text is added to the file.</string>
</file.out.open>
</body>
</xsql-script>