Method

GioDataInputStreamread_until_async

deprecated: 2.56 since: 2.20

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

Type: 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

Type: gint

The I/O priority of the request.

cancellable

Type: GCancellable

Optional GCancellable object, NULL to ignore.

The argument can be NULL.

The data is owned by the caller of the function.

callback

Type: GAsyncReadyCallback

Callback to call when the request is satisfied.

The argument can be NULL.

user_data

Type: gpointer

The data to pass to callback function.

The argument can be NULL.

The data is owned by the caller of the function.