Method

GLibIOChannelwrite_chars

Declaration

GIOStatus
g_io_channel_write_chars (
  GIOChannel* channel,
  const gchar* buf,
  gssize count,
  gsize* bytes_written,
  GError** error
)

Description

Replacement for g_io_channel_write() with the new API.

On seekable channels with encodings other than NULL or UTF-8, generic mixing of reading and writing is not allowed. A call to g_io_channel_write_chars () may only be made on a channel from which data has been read in the cases described in the documentation for g_io_channel_set_encoding ().

Parameters

`buf`	An array of `guint8`
	A buffer to write data from.
	The data is owned by the caller of the function.
`count`	`gssize`
	The size of the buffer. If -1, the buffer is taken to be a nul-terminated string.
`bytes_written`	`gsize*`
	The number of bytes written. This can be nonzero even if the return value is not `G_IO_STATUS_NORMAL`. If the return value is `G_IO_STATUS_NORMAL` and the channel is blocking, this will always be equal to `count` if `count` >= 0.
	The argument will be set by the function.
	The instance takes ownership of the data, and is responsible for freeing it.
`error`	`GError **`
	The return location for a `GError*`, or `NULL`.

Return value

Returns:	`GIOStatus`
	The status of the operation.