IOChannel.setEncoding

Sets the encoding for the input/output of the channel. The internal encoding is always UTF-8. The default encoding for the external file is UTF-8.

The encoding null is safe to use with binary data.

The encoding can only be set if one of the following conditions is true:

• The channel was just created, and has not been written to or read from yet.
• The channel is write-only.
• The channel is a file, and the file pointer was just repositioned by a call to glib.iochannel.IOChannel.seekPosition. (This flushes all the internal buffers.)
• The current encoding is null or UTF-8.
• One of the (new API) read functions has just returned G_IO_STATUS_EOF (or, in the case of glib.iochannel.IOChannel.readToEnd, G_IO_STATUS_NORMAL).
• One of the functions glib.iochannel.IOChannel.readChars or glib.iochannel.IOChannel.readUnichar has returned G_IO_STATUS_AGAIN or G_IO_STATUS_ERROR. This may be useful in the case of G_CONVERT_ERROR_ILLEGAL_SEQUENCE. Returning one of these statuses from glib.iochannel.IOChannel.readLine, glib.iochannel.IOChannel.readLineString, or glib.iochannel.IOChannel.readToEnd does not guarantee that the encoding can be changed.

Channels which do not meet one of the above conditions cannot call glib.iochannel.IOChannel.seekPosition with an offset of G_SEEK_CUR, and, if they are "seekable", cannot call glib.iochannel.IOChannel.writeChars after calling one of the API "read" functions.