read_line


Description:

public IOStatus read_line (out string str_return, out size_t length, out size_t terminator_pos) throws ConvertError, IOChannelError

Reads a line, including the terminating character(s), from a IOChannel into a newly-allocated string.

str_return will contain allocated memory if the return is g_io_status_normal.

Parameters:

this

a IOChannel

str_return

The line read from the IOChannel, including the line terminator. This data should be freed with g_free when no longer needed. This is a nul-terminated string. If a length of zero is returned, this will be null instead.

length

location to store length of the read data, or null

terminator_pos

location to store position of line terminator, or null

Returns:

the status of the operation.