async-io-state-send-message-to-address Function

Summary

Asynchronously sends a message on an unconnected socket.

Package

comm

Signature

async-io-state-send-message-to-address (async-io-state hostspec service buffer callback &key start end timeout error-callback user-info)

Arguments

Description

The function async-io-state-send-message-to-address asynchronously sends a message from buffer between start and end to the socket address which is specified by hostspec and service. For the interpretation of hostspec and service see 25.3 Specifying the target for connecting and binding a socket.

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

The socket in async-io-state must not be connected. When the sending is successful, callback is called with async-io-state as its only argument.

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

Notes

1. async-io-state-send-message-to-address 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.
2. The contents of buffer must not be changed before callback has been called.
3. If hostspec is a host name (that is a string not specifying an IP address), then async-io-state-send-message-to-address uses the family of the socket to decide whether to look for IPv6 or IPv4 addresses. If async-io-state was created by create-async-io-state, the ipv6 argument to create-async-io-state must match the family of the socket for async-io-state-send-message-to-address to work.
4. For connected UDP sockets, use async-io-state-send-message.

Examples

(example-edit-file "async-io/udp")

See also

create-async-io-state-and-connected-udp-socket
async-io-state-receive-message
async-io-state-send-message
25.7.2 The Async-I/O-State API
25 TCP and UDP socket communication and SSL