async-io-state-send-message

async-io-state-send-message Function

Summary

Asynchronously sends a message on a connected socket.

Package

comm

Signature

async-io-state-send-message async-io-state buffer callback &key start end timeout error-callback user-info

Arguments

`async-io-state`⇩	An async-io-state.
`buffer`⇩	A cl:base-string or an 8-bit cl:simple-array.
`callback`⇩	A function designator for a function of 1 argument.
`start`⇩	A lower bounding index designator for `buffer`.
`end`⇩	An upper bounding index designator for `buffer`.
`timeout`⇩	`nil` or a non-negative real.
`error-callback`⇩	A function designator.
`user-info`⇩	A Lisp object.

Description

The function async-io-state-send-message asynchronously sends a message from buffer between start and end. The socket in async-io-state must be connected. When the send is successful, callback is called with async-io-state as its only argument.

The default value of start is 0. The default value of end is the length of buffer.

error-callback, timeout, start, end and user-info have the same meaning as in async-io-state-write-buffer.

Notes

async-io-state-send-message is typically used only with an async-io-state containing a UDP socket, created by create-async-io-state-and-udp-socket, create-async-io-state-and-connected-udp-socket or calling create-async-io-state with udp non-nil.

The contents of buffer must not be changed before callback has been called.

For unconnected UDP sockets, use async-io-state-send-message-to-address.