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


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


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 stop_chars. May be -1 if stop_chars is nul-terminated.

io_priority gint

The [I/O priority][io-priority] of the request.

cancellable GCancellable

Optional GCancellable object, NULL to ignore.

 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.