Method

GioDataInputStreamread_line_finish

Declaration

char*
g_data_input_stream_read_line_finish (
  GDataInputStream* stream,
  GAsyncResult* result,
  gsize* length,
  GError** error
)

Description

Finish an asynchronous call started by g_data_input_stream_read_line_async(). Note the warning about string encoding in g_data_input_stream_read_line() applies here as well.

Available since:

2.20

Parameters

`result`	`GAsyncResult`
	The `GAsyncResult` that was provided to the callback.
	The data is owned by the caller of the function.
`length`	`gsize*`
	A #gsize to get the length of the data read in.
	The argument will be set by the function.
	The argument can be `NULL`.
`error`	`GError **`
	The return location for a `GError*`, or `NULL`.

Return value

Returns:	An array of `guint8`
	a NUL-terminated byte array with the line that was read in (without the newlines). Set `length` to a #gsize to get the length of the read line. On an error, it will return `NULL` and `error` will be set. If there’s no content to read, it will still return `NULL`, but `error` won’t be set.
	The array is `NULL`-terminated.
	The caller of the method takes ownership of the data, and is responsible for freeing it.
	The return value can be `NULL`.