Struct websocket_lite::Message

pub struct Message { /* fields omitted */ }

A text string, a block of binary data or a WebSocket control frame.

Implementations

impl Message

pub fn new<B>(opcode: Opcode, data: B) -> Result<Message, Utf8Error> where
    B: Into<Bytes>, 

Creates a message from a Bytes object.

The message can be tagged as text or binary. When the opcode parameter is Opcode::Text this function validates the bytes in data and returns Err if they do not contain valid UTF-8 text.

pub fn text<S>(data: S) -> Message where
    S: Into<String>, 

Creates a text message from a String.

pub fn binary<B>(data: B) -> Message where
    B: Into<Bytes>, 

Creates a binary message from any type that can be converted to Bytes, such as &[u8] or Vec<u8>.

pub fn close(reason: Option<(u16, String)>) -> Message

Creates a message that indicates the connection is about to be closed.

The reason parameter is an optional numerical status code and text description. Valid reasons may be defined by a particular WebSocket server.

pub fn ping<B>(data: B) -> Message where
    B: Into<Bytes>, 

Creates a message requesting a pong response.

The client can send one of these to request a pong response from the server.

pub fn pong<B>(data: B) -> Message where
    B: Into<Bytes>, 

Creates a response to a ping message.

The client can send one of these in response to a ping from the server.

pub fn opcode(&self) -> Opcode

Returns this message's WebSocket opcode.

pub fn data(&self) -> &Bytes

Returns a reference to the data held in this message.

pub fn into_data(self) -> Bytes

Consumes the message, returning its data.

pub fn as_text(&self) -> Option<&str>

For messages with opcode Opcode::Text, returns a reference to the text. Returns None otherwise.

Trait Implementations

impl Clone for Message

pub fn clone(&self) -> Message

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Message

pub fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<'a> Encoder<&'a Message> for MessageCodec

type Error = Box<dyn Error + 'static + Sync + Send>

The type of encoding errors.

pub fn encode(
    &mut self,
    item: &Message,
    dst: &mut BytesMut
) -> Result<(), Box<dyn Error + 'static + Sync + Send>>

Encodes a frame into the buffer provided.

impl Encoder<Message> for MessageCodec

type Error = Box<dyn Error + 'static + Sync + Send>

The type of encoding errors.

pub fn encode(
    &mut self,
    item: Message,
    dst: &mut BytesMut
) -> Result<(), Box<dyn Error + 'static + Sync + Send>>

Encodes a frame into the buffer provided.

impl PartialEq<Message> for Message

pub fn eq(&self, other: &Message) -> bool

This method tests for self and other values to be equal, and is used by ==.

pub fn ne(&self, other: &Message) -> bool

This method tests for !=.

impl StructuralPartialEq for Message