Method
GioDataInputStreamread_upto_async
Declaration
void
g_data_input_stream_read_upto_async (
GDataInputStream* stream,
const gchar* stop_chars,
gssize stop_chars_len,
gint io_priority,
GCancellable* cancellable,
GAsyncReadyCallback callback,
gpointer user_data
)
Description
The asynchronous version of g_data_input_stream_read_upto(). It is an error to have two outstanding calls to this function.
In contrast to g_data_input_stream_read_until(), this function
does not consume the stop character. You have to use
g_data_input_stream_read_byte()
to get it before calling
g_data_input_stream_read_upto()
again.
Note that stop_chars
may contain ‘\0’ if stop_chars_len
is specified.
When the operation is finished, callback
will be called. You
can then call g_data_input_stream_read_upto_finish()
to get
the result of the operation.
Available since: | 2.26 |
Parameters
stop_chars |
const gchar* |
Characters to terminate the read. |
|
The data is owned by the caller of the function. | |
The value is a NUL terminated UTF-8 string. | |
stop_chars_len |
gssize |
Length of |
|
io_priority |
gint |
The [I/O priority][io-priority] of the request. |
|
cancellable |
GCancellable |
Optional |
|
The argument can be NULL . | |
The data is owned by the caller of the function. | |
callback |
GAsyncReadyCallback |
Callback to call when the request is satisfied. |
|
The argument can be NULL . | |
user_data |
gpointer |
The data to pass to callback function. |
|
The argument can be NULL . | |
The data is owned by the caller of the function. |