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.

Values

None.

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 until callback has been called.

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

See also

create-async-io-state-and-connected-udp-socket
async-io-state-receive-message
async-io-state-send-message-to-address
The Async-I/O-State API