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

class DataInputStream
string
readLineUtf8

Parameters

length gsize

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

cancellable Cancellable

optional GCancellable object, NULL to ignore. [allow-none]

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. [transfer full]

Throws

GException on failure.

Meta