GBytes* g_input_stream_read_bytes ( GInputStream* stream, gsize count, GCancellable* cancellable, GError** error )
Like g_input_stream_read(), this tries to read
count bytes from
the stream in a blocking fashion. However, rather than reading into
a user-supplied buffer, this will create a new
the data that was read. This may be easier to use from language bindings.
If count is zero, returns a zero-length
GBytes and does nothing. A
count larger than
G_MAXSSIZE will cause a
On success, a new
GBytes is returned. It is not an error if the
size of this object is not the same as the requested size, as it
can happen e.g. near the end of a file. A zero-length
returned on end of file (or if
count is zero), but never otherwise.
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. If an
operation was partially finished when the operation was cancelled the
partial result will be returned, without an error.
NULL is returned and
error is set accordingly.
Maximum number of bytes that will be read from the stream. Common values include 4096 and 8192.
|The argument can be |
|The data is owned by the caller of the function.|
|The return location for a
|The caller of the method takes ownership of the data, and is responsible for freeing it.|