Method

GLibIOChannelread_to_end

Declaration

GIOStatus
g_io_channel_read_to_end (
  GIOChannel* channel,
  gchar** str_return,
  gsize* length,
  GError** error
)

Description

Reads all the remaining data from the file.

Parameters

str_return An array of guint8
 

Location to store a pointer to a string holding the remaining data in the GIOChannel. This data should be freed with g_free() when no longer needed. This data is terminated by an extra nul character, but there may be other nuls in the intervening data.

 The argument will be set by the function.
 The length of the array is specified in the length argument.
 The instance takes ownership of the data, and is responsible for freeing it.
length gsize*
 

Location to store length of the data.

 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
 

G_IO_STATUS_NORMAL on success. This function never returns G_IO_STATUS_EOF.