Method

GioDataInputStreamread_until_async

Declaration

void
g_data_input_stream_read_until_async (
  GDataInputStream* stream,
  const gchar* stop_chars,
  gint io_priority,
  GCancellable* cancellable,
  GAsyncReadyCallback callback,
  gpointer user_data
)

Description

The asynchronous version of g_data_input_stream_read_until(). It is an error to have two outstanding calls to this function.

Note that, in contrast to g_data_input_stream_read_until(), this function does not consume the stop character that it finds. You must read it for yourself.

When the operation is finished, callback will be called. You can then call g_data_input_stream_read_until_finish() to get the result of the operation.

Don’t use this function in new code. Its functionality is inconsistent with g_data_input_stream_read_until(). Both functions will be marked as deprecated in a future release. Use g_data_input_stream_read_upto_async() instead.

Available since:2.20
Deprecated since:2.56

Use g_data_input_stream_read_upto_async() instead, which has more consistent behaviour regarding the stop character.

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