Enum redis_protocol::resp3::types::OwnedFrame

pub enum OwnedFrame {
    BlobString {
        data: Vec<u8>,
        attributes: Option<OwnedAttributes>,
    },
    BlobError {
        data: Vec<u8>,
        attributes: Option<OwnedAttributes>,
    },
    SimpleString {
        data: Vec<u8>,
        attributes: Option<OwnedAttributes>,
    },
    SimpleError {
        data: String,
        attributes: Option<OwnedAttributes>,
    },
    Boolean {
        data: bool,
        attributes: Option<OwnedAttributes>,
    },
    Null,
    Number {
        data: i64,
        attributes: Option<OwnedAttributes>,
    },
    Double {
        data: f64,
        attributes: Option<OwnedAttributes>,
    },
    BigNumber {
        data: Vec<u8>,
        attributes: Option<OwnedAttributes>,
    },
    VerbatimString {
        data: Vec<u8>,
        format: VerbatimStringFormat,
        attributes: Option<OwnedAttributes>,
    },
    Array {
        data: Vec<OwnedFrame>,
        attributes: Option<OwnedAttributes>,
    },
    Map {
        data: FrameMap<OwnedFrame, OwnedFrame>,
        attributes: Option<OwnedAttributes>,
    },
    Set {
        data: FrameSet<OwnedFrame>,
        attributes: Option<OwnedAttributes>,
    },
    Push {
        data: Vec<OwnedFrame>,
        attributes: Option<OwnedAttributes>,
    },
    Hello {
        version: RespVersion,
        auth: Option<(String, String)>,
        setname: Option<String>,
    },
    ChunkedString(Vec<u8>),
}

Available on crate feature resp3 only.

An enum describing a RESP3 frame that uses owned byte containers.

https://github.com/antirez/RESP3/blob/master/spec.md

Variants

BlobString

A blob of bytes.

Fields

data: Vec<u8>

attributes: Option<OwnedAttributes>

BlobError

A blob representing an error.

Fields

data: Vec<u8>

attributes: Option<OwnedAttributes>

SimpleString

A small string.

The internal data type is Vec<u8> in order to support callers that use this interface to parse a MONITOR stream.

Fields

data: Vec<u8>

attributes: Option<OwnedAttributes>

SimpleError

A small string representing an error.

Fields

data: String

attributes: Option<OwnedAttributes>

Boolean

A boolean type.

Fields

data: bool

attributes: Option<OwnedAttributes>

Null

A null type.

Number

A signed 64-bit integer.

Fields

data: i64

attributes: Option<OwnedAttributes>

Double

A signed 64-bit floating point number.

Fields

data: f64

attributes: Option<OwnedAttributes>

BigNumber

A large number not representable as a Number or Double.

This library does not attempt to parse this.

Fields

data: Vec<u8>

attributes: Option<OwnedAttributes>

VerbatimString

A string to be displayed without any escaping or filtering.

Fields

data: Vec<u8>

format: VerbatimStringFormat

attributes: Option<OwnedAttributes>

Array

An array of frames.

Fields

data: Vec<OwnedFrame>

attributes: Option<OwnedAttributes>

Map

An unordered map of key-value pairs.

According to the spec keys can be any other RESP3 data type. However, it doesn’t make sense to implement Hash for certain aggregate types. The can_hash function can be used to detect this.

Fields

data: FrameMap<OwnedFrame, OwnedFrame>

attributes: Option<OwnedAttributes>

Set

An unordered collection of other frames with a uniqueness constraint.

Fields

data: FrameSet<OwnedFrame>

attributes: Option<OwnedAttributes>

Push

Out-of-band data.

Fields

data: Vec<OwnedFrame>

attributes: Option<OwnedAttributes>

Hello

A special frame type used when first connecting to the server to describe the protocol version and optional credentials.

Fields

version: RespVersion

auth: Option<(String, String)>

setname: Option<String>

ChunkedString(Vec<u8>)

One chunk of a streaming blob.

Implementations

impl OwnedFrame

pub fn into_bytes_frame(self) -> BytesFrame

Available on crate feature bytes only.

Move the frame contents into a new BytesFrame.

Trait Implementations

impl Clone for OwnedFrame

fn clone(&self) -> OwnedFrame

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for OwnedFrame

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

Formats the value using the given formatter.

impl From<bool> for OwnedFrame

fn from(value: bool) -> Self

Converts to this type from the input type.

impl From<f64> for OwnedFrame

fn from(value: f64) -> Self

Converts to this type from the input type.

impl From<i64> for OwnedFrame

fn from(value: i64) -> Self

Converts to this type from the input type.

impl<T, const N: usize> FromResp3<OwnedFrame> for [T; N]

where T: FromResp3<OwnedFrame>,

Available on crate feature convert only.

fn from_frame(value: OwnedFrame) -> Result<[T; N], RedisProtocolError>

Convert a frame to the destination type.

fn from_frames(frames: Vec<F>) -> Result<Vec<Self>, RedisProtocolError>

Convert multiple frames to the destination type.

impl FromResp3<OwnedFrame> for ()

Available on crate feature convert only.

fn from_frame(_: OwnedFrame) -> Result<Self, RedisProtocolError>

Convert a frame to the destination type.

fn from_frames(frames: Vec<F>) -> Result<Vec<Self>, RedisProtocolError>

Convert multiple frames to the destination type.

impl<K, V, S> FromResp3<OwnedFrame> for HashMap<K, V, S>

where K: FromResp3<OwnedFrame> + Eq + Hash, V: FromResp3<OwnedFrame>, S: BuildHasher + Default,

Available on crate feature convert only.

fn from_frame(frame: OwnedFrame) -> Result<Self, RedisProtocolError>

Convert a frame to the destination type.

fn from_frames(frames: Vec<F>) -> Result<Vec<Self>, RedisProtocolError>

Convert multiple frames to the destination type.

impl<V, S> FromResp3<OwnedFrame> for HashSet<V, S>

where V: FromResp3<OwnedFrame> + Hash + Eq, S: BuildHasher + Default,

Available on crate feature convert only.

fn from_frame(frame: OwnedFrame) -> Result<Self, RedisProtocolError>

Convert a frame to the destination type.

fn from_frames(frames: Vec<F>) -> Result<Vec<Self>, RedisProtocolError>

Convert multiple frames to the destination type.

impl<T> FromResp3<OwnedFrame> for Option<T>

where T: FromResp3<OwnedFrame>,

Available on crate feature convert only.

fn from_frame(frame: OwnedFrame) -> Result<Option<T>, RedisProtocolError>

Convert a frame to the destination type.

fn from_frames(frames: Vec<F>) -> Result<Vec<Self>, RedisProtocolError>

Convert multiple frames to the destination type.

impl FromResp3<OwnedFrame> for OwnedFrame

Available on crate feature convert only.

fn from_frame(frame: OwnedFrame) -> Result<Self, RedisProtocolError>

Convert a frame to the destination type.

fn from_frames(frames: Vec<F>) -> Result<Vec<Self>, RedisProtocolError>

Convert multiple frames to the destination type.

impl FromResp3<OwnedFrame> for String

Available on crate feature convert only.

fn from_frame(frame: OwnedFrame) -> Result<Self, RedisProtocolError>

Convert a frame to the destination type.

fn from_frames(frames: Vec<F>) -> Result<Vec<Self>, RedisProtocolError>

Convert multiple frames to the destination type.

impl<T> FromResp3<OwnedFrame> for Vec<T>

where T: FromResp3<OwnedFrame>,

Available on crate feature convert only.

fn from_frame(frame: OwnedFrame) -> Result<Vec<T>, RedisProtocolError>

Convert a frame to the destination type.

fn from_frames(frames: Vec<F>) -> Result<Vec<Self>, RedisProtocolError>

Convert multiple frames to the destination type.

impl FromResp3<OwnedFrame> for bool

Available on crate feature convert only.

fn from_frame(frame: OwnedFrame) -> Result<Self, RedisProtocolError>

Convert a frame to the destination type.

fn from_frames(frames: Vec<F>) -> Result<Vec<Self>, RedisProtocolError>

Convert multiple frames to the destination type.

impl FromResp3<OwnedFrame> for f32

Available on crate feature convert only.

fn from_frame(frame: OwnedFrame) -> Result<Self, RedisProtocolError>

Convert a frame to the destination type.

fn from_frames(frames: Vec<F>) -> Result<Vec<Self>, RedisProtocolError>

Convert multiple frames to the destination type.

impl FromResp3<OwnedFrame> for f64

Available on crate feature convert only.

fn from_frame(frame: OwnedFrame) -> Result<Self, RedisProtocolError>

Convert a frame to the destination type.

fn from_frames(frames: Vec<F>) -> Result<Vec<Self>, RedisProtocolError>

Convert multiple frames to the destination type.

impl FromResp3<OwnedFrame> for i128

Available on crate feature convert only.

fn from_frame(value: OwnedFrame) -> Result<i128, RedisProtocolError>

Convert a frame to the destination type.

fn from_frames(frames: Vec<F>) -> Result<Vec<Self>, RedisProtocolError>

Convert multiple frames to the destination type.

impl FromResp3<OwnedFrame> for i16

Available on crate feature convert only.

fn from_frame(value: OwnedFrame) -> Result<i16, RedisProtocolError>

Convert a frame to the destination type.

fn from_frames(frames: Vec<F>) -> Result<Vec<Self>, RedisProtocolError>

Convert multiple frames to the destination type.

impl FromResp3<OwnedFrame> for i32

Available on crate feature convert only.

fn from_frame(value: OwnedFrame) -> Result<i32, RedisProtocolError>

Convert a frame to the destination type.

fn from_frames(frames: Vec<F>) -> Result<Vec<Self>, RedisProtocolError>

Convert multiple frames to the destination type.

impl FromResp3<OwnedFrame> for i64

Available on crate feature convert only.

fn from_frame(value: OwnedFrame) -> Result<i64, RedisProtocolError>

Convert a frame to the destination type.

fn from_frames(frames: Vec<F>) -> Result<Vec<Self>, RedisProtocolError>

Convert multiple frames to the destination type.

impl FromResp3<OwnedFrame> for i8

Available on crate feature convert only.

fn from_frame(value: OwnedFrame) -> Result<i8, RedisProtocolError>

Convert a frame to the destination type.

fn from_frames(frames: Vec<F>) -> Result<Vec<Self>, RedisProtocolError>

Convert multiple frames to the destination type.

impl FromResp3<OwnedFrame> for isize

Available on crate feature convert only.

fn from_frame(value: OwnedFrame) -> Result<isize, RedisProtocolError>

Convert a frame to the destination type.

fn from_frames(frames: Vec<F>) -> Result<Vec<Self>, RedisProtocolError>

Convert multiple frames to the destination type.

impl FromResp3<OwnedFrame> for u128

Available on crate feature convert only.

fn from_frame(value: OwnedFrame) -> Result<u128, RedisProtocolError>

Convert a frame to the destination type.

fn from_frames(frames: Vec<F>) -> Result<Vec<Self>, RedisProtocolError>

Convert multiple frames to the destination type.

impl FromResp3<OwnedFrame> for u16

Available on crate feature convert only.

fn from_frame(value: OwnedFrame) -> Result<u16, RedisProtocolError>

Convert a frame to the destination type.

fn from_frames(frames: Vec<F>) -> Result<Vec<Self>, RedisProtocolError>

Convert multiple frames to the destination type.

impl FromResp3<OwnedFrame> for u32

Available on crate feature convert only.

fn from_frame(value: OwnedFrame) -> Result<u32, RedisProtocolError>

Convert a frame to the destination type.

fn from_frames(frames: Vec<F>) -> Result<Vec<Self>, RedisProtocolError>

Convert multiple frames to the destination type.

impl FromResp3<OwnedFrame> for u64

Available on crate feature convert only.

fn from_frame(value: OwnedFrame) -> Result<u64, RedisProtocolError>

Convert a frame to the destination type.

fn from_frames(frames: Vec<F>) -> Result<Vec<Self>, RedisProtocolError>

Convert multiple frames to the destination type.

impl FromResp3<OwnedFrame> for u8

Available on crate feature convert only.

fn from_frame(frame: OwnedFrame) -> Result<Self, RedisProtocolError>

Convert a frame to the destination type.

fn from_frames(frames: Vec<F>) -> Result<Vec<Self>, RedisProtocolError>

Convert multiple frames to the destination type.

impl FromResp3<OwnedFrame> for usize

Available on crate feature convert only.

fn from_frame(value: OwnedFrame) -> Result<usize, RedisProtocolError>

Convert a frame to the destination type.

fn from_frames(frames: Vec<F>) -> Result<Vec<Self>, RedisProtocolError>

Convert multiple frames to the destination type.

impl Hash for OwnedFrame

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for OwnedFrame

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

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

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Resp3Frame for OwnedFrame

type Attributes = HashMap<OwnedFrame, OwnedFrame>

fn from_buffer( target: FrameKind, buf: impl IntoIterator<Item = Self>, attributes: Option<Self::Attributes> ) -> Result<Self, RedisProtocolError>

Create the target aggregate type based on a buffered set of chunked frames.

fn add_attributes( &mut self, attributes: Self::Attributes ) -> Result<(), RedisProtocolError>

Attempt to add attributes to the frame, extending the existing attributes if needed.

fn attributes(&self) -> Option<&Self::Attributes>

Read the attributes attached to the frame.

fn attributes_mut(&mut self) -> Option<&mut Self::Attributes>

Read a mutable reference to any attributes attached to the frame.

fn take_attributes(&mut self) -> Option<Self::Attributes>

Take the attributes off this frame.

fn new_end_stream() -> Self

Create a new frame that terminates a stream.

fn new_empty() -> Self

Create a new empty frame with attribute support.

fn len(&self) -> usize

A context-aware length function that returns the length of the inner frame contents.

fn take(&mut self) -> Self

Replace self with Null, returning the original value.

fn kind(&self) -> FrameKind

Read the associated FrameKind.

fn is_end_stream_frame(&self) -> bool

Whether the frame is an empty chunked string, signifying the end of a chunked string stream.

fn verbatim_string_format(&self) -> Option<&VerbatimStringFormat>

If the frame is a verbatim string then read the associated format.

fn as_str(&self) -> Option<&str>

Read the frame as a string slice if it can be parsed as a UTF-8 string without allocating.

fn as_bool(&self) -> Option<bool>

Attempt to convert the frame to a bool.

fn to_string(&self) -> Option<String>

Read the frame as a String if it can be parsed as a UTF-8 string.

fn as_bytes(&self) -> Option<&[u8]>

Attempt to read the frame as a byte slice.

fn encode_len(&self) -> usize

Read the number of bytes necessary to represent the frame and any associated attributes.

fn is_normal_pubsub_message(&self) -> bool

Whether the frame is a message from a subscribe call.

fn is_pattern_pubsub_message(&self) -> bool

Whether the frame is a message from a psubscribe call.

fn is_shard_pubsub_message(&self) -> bool

Whether the frame is a message from a ssubscribe call.

fn is_single_element_vec(&self) -> bool

Available on crate feature convert only.

Whether frame is a bulk array with a single element.

fn pop_or_take(self) -> Self

Available on crate feature convert only.

Pop an element from the inner array or return the original frame.

fn is_redirection(&self) -> bool

Whether the frame is a MOVED or ASK redirection.

fn as_f64(&self) -> Option<f64>

Convert the frame to a double.

fn convert<T>(self) -> Result<T, RedisProtocolError>

where Self: Sized, T: FromResp3<Self>,

Available on crate feature convert only.

Convert the frame to another type.

impl<B: Into<Vec<u8>>> TryFrom<(FrameKind, B)> for OwnedFrame

type Error = RedisProtocolError

The type returned in the event of a conversion error.

fn try_from((kind, buf): (FrameKind, B)) -> Result<Self, Self::Error>

Performs the conversion.

impl Eq for OwnedFrame

impl StructuralPartialEq for OwnedFrame