DOKK / manpages / debian 12 / libwslay-doc / wslay_event_queue_msg_ex.3.en
WSLAY_EVENT_QUEUE_MSG_EX(3) wslay WSLAY_EVENT_QUEUE_MSG_EX(3)

wslay_event_queue_msg_ex - Queue a message for future transmission

#include <wslay/wslay.h>



wslay_event_queue_msg() and wslay_event_queue_msg_ex() queue message specified in arg. The struct wslay_event_msg is defined as:

struct wslay_event_msg {


    uint8_t        opcode;


    const uint8_t *msg;


    size_t         msg_length;
};


The opcode member is opcode of the message. The msg member is the pointer to the message data. The msg_length member is the length of message data.

This function supports both control and non-control messages and the given message is sent without fragmentation. If fragmentation is needed, use wslay_event_queue_fragmented_msg() function instead.

This function makes a copy of msg of length msg_length.

This function just queues a message and does not send it. wslay_event_send() function call sends these queued messages.

wslay_event_queue_msg_ex() additionally accepts rsv parameter, which is a reserved bits to send. To set reserved bits, use macro WSLAY_RSV1_BIT, WSLAY_RSV2_BIT, and WSLAY_RSV3_BIT. See wslay_event_config_set_allowed_rsv_bits() to see the allowed reserved bits to set.

wslay_event_queue_msg() and wslay_event_queue_msg_ex() return 0 if it succeeds, or returns the following negative error codes:

Could not queue given message. The one of possible reason is that close control frame has been queued/sent and no further queueing message is not allowed.
The given message is invalid; or RSV1 is set for control frame; or bit is set in rsv which is not allowed (see wslay_event_config_set_allowed_rsv_bits()).
Out of memory.

wslay_event_queue_fragmented_msg(), wslay_event_queue_fragmented_msg_ex(), wslay_event_queue_close()

Tatsuhiro Tsujikawa

2021, 2015, Tatsuhiro Tsujikawa

November 7, 2021 @PACKAGE_VERSION@