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 `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.