Function TCPConnection.waitForDataAsync
Waits asynchronously for new data to arrive.
WaitForDataAsyncStatus waitForDataAsync(CALLABLE)
(
CALLABLE read_ready_callback,
Duration timeout = Duration
)
if (is(typeof(()
{
read_ready_callback(true);
}
())));
This function can be used to detach the TCPConnection from a
running task while waiting for data, so that the associated memory
resources are available for other operations.
Note that read_ready_callback may be called from outside of a
task, so no blocking operations may be performed. Instead, an existing
task should be notified, or a new one started with runTask.
Parameters
| Name | Description |
|---|---|
| read_ready_callback | A callback taking a bool parameter that
signals the read-readiness of the connection |
| timeout | Optional timeout to limit the maximum wait time |
Returns
If the read readiness can be determined immediately, it will be
returned as WaitForDataAsyncStatus.sataAvailable` or
WaitForDataAsyncStatus and the callback will not be
invoked. Otherwise WaitForDataAsyncStatus is returned
and the callback will be invoked once the status can be
determined or the specified timeout is reached.