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.