DataInputStream.readLineUtf8

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.

class DataInputStream
string
readLineUtf8

Parameters

length size_t

a gsize to get the length of the data read in.

cancellable Cancellable

optional gio.Cancellable object, NULL to ignore.

Return Value

Type: string

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.

Throws

GException on failure.

Meta

Since

2.30