Method

GioDataInputStreamread_line_utf8

Declaration

char*
g_data_input_stream_read_line_utf8 (
  GDataInputStream* stream,
  gsize* length,
  GCancellable* cancellable,
  GError** error
)

Description

Reads a UTF-8 encoded line from the data input stream.

If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

Available since:

2.30

Parameters

`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`.
`cancellable`	`GCancellable`
	Optional `GCancellable` object, `NULL` to ignore.
	The argument can be `NULL`.
	The data is owned by the caller of the function.
`error`	`GError **`
	The return location for a `GError*`, or `NULL`.

Return value

Returns:	`char*`
	A NUL terminated UTF-8 string 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. For UTF-8 conversion errors, the set error domain is `G_CONVERT_ERROR`. If there’s no content to read, it will still return `NULL`, but `error` won’t be set.
	The caller of the method takes ownership of the data, and is responsible for freeing it.
	The return value can be `NULL`.
	The value is a NUL terminated UTF-8 string.