Stops the current read operation in an async-io-state.
The function async-io-state-finish stops the current read operation in async-io-state, so no further calls to the async-io-state-read-with-checking callback will occur. If discard is non-nil, then it discards the first discard bytes from the internal buffer in async-io-state. The rest of the buffer is preserved for future reading.
async-io-state-finish must only be called inside the scope of the callback of async-io-state-read-with-checking. Once async-io-state-finish has been called, the callback must not access the buffer again and a new read operation can be started.
The return value unread-buffer-length is the remaining number of bytes in the buffer.
LispWorks User Guide and Reference Manual - 13 Feb 2015