async-io-state-wait-for-input

async-io-state-wait-for-input Function

Summary

Asynchronously waits for input to be available from an async-io-state.

Package

comm

Signature

async-io-state-wait-for-input async-io-state callback &key timeout user-info

Arguments

`async-io-state`⇩	An async-io-state.
`callback`⇩	A function designator for a function of 1 argument.
`timeout`⇩	`nil` or a positive real.
`user-info`⇩	A Lisp object.

Description

The function async-io-state-wait-for-input waits for input to be available from async-io-state. When input is available, callback is called with async-io-state as its argument.

If the operation does not finish within the state's async-io-state-read-timeout period then state's async-io-state-read-status is set to :timeout and callback is called.

If timeout or user-info are supplied then they set async-io-state-read-timeout and async-io-state-user-info in async-io-state for this and subsequent operations.

If another read operation on the state is in progress, an error is signaled.

Notes

async-io-state-wait-for-input cannot have SSL attached to it.