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 |
|
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
|
|
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. |