Struct arc_bytes::serde::CowBytes

source · [−]

pub struct CowBytes<'a>(pub Cow<'a, [u8]>);

Expand description

A Cow<'a, [u8]> wrapper that supports serializing efficiently in Serde.

Tuple Fields

0: Cow<'a, [u8]>

Implementations

impl<'a> CowBytes<'a>

pub fn into_cow(self) -> Cow<'a, [u8 ]>

Returns the underlying Cow.

pub fn into_vec(self) -> Vec<u8>

Returns the underlying Vec inside of the Cow, or clones the borrowed bytes into a new Vec..

pub fn as_slice(&self) -> &[u8 ]ⓘNotable traits for &'_ mut [u8 ]`impl<'_> Write for &'_ mut [u8]impl<'_> Read for &'_ [u8]`

Returns a slice of the contained data.

Methods from Deref<Target = Cow<'a, [u8 ]>>

pub fn is_borrowed(&self) -> bool

🔬 This is a nightly-only experimental API. (cow_is_borrowed)

Returns true if the data is borrowed, i.e. if to_mut would require additional work.

Examples

#![feature(cow_is_borrowed)]
use std::borrow::Cow;

let cow = Cow::Borrowed("moo");
assert!(cow.is_borrowed());

let bull: Cow<'_, str> = Cow::Owned("...moo?".to_string());
assert!(!bull.is_borrowed());

pub fn is_owned(&self) -> bool

🔬 This is a nightly-only experimental API. (cow_is_borrowed)

Returns true if the data is owned, i.e. if to_mut would be a no-op.

Examples

#![feature(cow_is_borrowed)]
use std::borrow::Cow;

let cow: Cow<'_, str> = Cow::Owned("moo".to_string());
assert!(cow.is_owned());

let bull = Cow::Borrowed("...moo?");
assert!(!bull.is_owned());

1.0.0 · source

pub fn to_mut(&mut self) -> &mut <B as ToOwned>::Owned

Acquires a mutable reference to the owned form of the data.

Clones the data if it is not already owned.

Examples

use std::borrow::Cow;

let mut cow = Cow::Borrowed("foo");
cow.to_mut().make_ascii_uppercase();

assert_eq!(
  cow,
  Cow::Owned(String::from("FOO")) as Cow<str>
);

Trait Implementations

impl<'a> Clone for CowBytes<'a>

fn clone(&self) -> CowBytes<'a>

Returns a copy of the value. Read more

1.0.0 · source

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

Performs copy-assignment from source. Read more

impl<'a> Debug for CowBytes<'a>

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

Formats the value using the given formatter. Read more

impl<'a> Default for CowBytes<'a>

fn default() -> CowBytes<'a>

Returns the “default value” for a type. Read more

impl<'a> Deref for CowBytes<'a>

type Target = Cow<'a, [u8 ]>

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<'a> DerefMut for CowBytes<'a>

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl<'de: 'a, 'a> Deserialize<'de> for CowBytes<'a>

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error> where
D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more

impl<'a, const N: usize> From<&'a [u8 ; N]> for CowBytes<'a>

fn from(buffer: &'a [u8 ; N]) -> Self

Performs the conversion.

impl<'a> From<&'a [u8 ]> for CowBytes<'a>

fn from(buffer: &'a [u8 ]) -> Self

Performs the conversion.

impl<'a, const N: usize> From<[u8 ; N]> for CowBytes<'a>

fn from(buffer: [u8 ; N]) -> Self

Performs the conversion.

impl<'a> From<Bytes> for CowBytes<'a>

fn from(bytes: Bytes) -> Self

Performs the conversion.

impl<'a> From<CowBytes<'a>> for Bytes

fn from(bytes: CowBytes<'a>) -> Self

Performs the conversion.

impl<'a> From<CowBytes<'a>> for ArcBytes<'a>

fn from(bytes: CowBytes<'a>) -> Self

Performs the conversion.

impl<'a> From<Vec<u8, Global>> for CowBytes<'a>

fn from(buffer: Vec<u8>) -> Self

Performs the conversion.

impl<'a> Hash for CowBytes<'a>

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

Feeds this value into the given Hasher. Read more

1.3.0 · source

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

Feeds a slice of this type into the given Hasher. Read more

impl<'a> Ord for CowBytes<'a>

fn cmp(&self, other: &CowBytes<'a>) -> Ordering

This method returns an Ordering between self and other. Read more

1.21.0 · source

fn max(self, other: Self) -> Self

Compares and returns the maximum of two values. Read more

1.21.0 · source

fn min(self, other: Self) -> Self

Compares and returns the minimum of two values. Read more

1.50.0 · source

fn clamp(self, min: Self, max: Self) -> Self

Restrict a value to a certain interval. Read more

impl<'a, 'b, const N: usize> PartialEq<&'b [u8 ; N]> for CowBytes<'a>

fn eq(&self, other: &&'b [u8 ; N]) -> bool

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

1.0.0 · source

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

This method tests for !=.

impl<'a, 'b> PartialEq<&'b [u8 ]> for CowBytes<'a>

fn eq(&self, other: &&'b [u8 ]) -> bool

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

1.0.0 · source

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

This method tests for !=.

impl<'a, const SIZE: usize> PartialEq<[u8 ; SIZE]> for CowBytes<'a>

fn eq(&self, other: &[u8 ; SIZE]) -> bool

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

1.0.0 · source

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

This method tests for !=.

impl<'a> PartialEq<[u8 ]> for CowBytes<'a>

fn eq(&self, other: &[u8 ]) -> bool

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

1.0.0 · source

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

This method tests for !=.

impl<'a> PartialEq<CowBytes<'a>> for CowBytes<'a>

fn eq(&self, other: &CowBytes<'a>) -> bool

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

fn ne(&self, other: &CowBytes<'a>) -> bool

This method tests for !=.

impl<'a, 'b, const SIZE: usize> PartialOrd<&'b [u8 ; SIZE]> for CowBytes<'a>

fn partial_cmp(&self, other: &&'b [u8 ; SIZE]) -> Option<Ordering>

This method returns an ordering between self and other values if one exists. Read more

1.0.0 · source

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

This method tests less than (for self and other) and is used by the < operator. Read more

1.0.0 · source

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

This method tests less than or equal to (for self and other) and is used by the <= operator. Read more

1.0.0 · source

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

This method tests greater than (for self and other) and is used by the > operator. Read more

1.0.0 · source

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

This method tests greater than or equal to (for self and other) and is used by the >= operator. Read more

impl<'b, 'a> PartialOrd<&'b [u8 ]> for CowBytes<'a>

fn partial_cmp(&self, other: &&'b [u8 ]) -> Option<Ordering>

This method returns an ordering between self and other values if one exists. Read more

1.0.0 · source

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

This method tests less than (for self and other) and is used by the < operator. Read more

1.0.0 · source

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

This method tests less than or equal to (for self and other) and is used by the <= operator. Read more

1.0.0 · source

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

This method tests greater than (for self and other) and is used by the > operator. Read more

1.0.0 · source

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

This method tests greater than or equal to (for self and other) and is used by the >= operator. Read more

impl<'a> PartialOrd<[u8 ]> for CowBytes<'a>

fn partial_cmp(&self, other: &[u8 ]) -> Option<Ordering>

This method returns an ordering between self and other values if one exists. Read more

1.0.0 · source

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

This method tests less than (for self and other) and is used by the < operator. Read more

1.0.0 · source

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

This method tests less than or equal to (for self and other) and is used by the <= operator. Read more

1.0.0 · source

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

This method tests greater than (for self and other) and is used by the > operator. Read more

1.0.0 · source

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

This method tests greater than or equal to (for self and other) and is used by the >= operator. Read more

impl<'a> PartialOrd<CowBytes<'a>> for CowBytes<'a>

fn partial_cmp(&self, other: &CowBytes<'a>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists. Read more

1.0.0 · source

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

This method tests less than (for self and other) and is used by the < operator. Read more

1.0.0 · source

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

This method tests less than or equal to (for self and other) and is used by the <= operator. Read more

1.0.0 · source

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

This method tests greater than (for self and other) and is used by the > operator. Read more

1.0.0 · source

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

This method tests greater than or equal to (for self and other) and is used by the >= operator. Read more

impl<'a> Serialize for CowBytes<'a>

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error> where
S: Serializer,

Serialize this value into the given Serde serializer. Read more

impl<'a> Eq for CowBytes<'a>

impl<'a> StructuralEq for CowBytes<'a>

impl<'a> StructuralPartialEq for CowBytes<'a>

Auto Trait Implementations

impl<'a> RefUnwindSafe for CowBytes<'a>

impl<'a> Send for CowBytes<'a>

impl<'a> Sync for CowBytes<'a>

impl<'a> Unpin for CowBytes<'a>

impl<'a> UnwindSafe for CowBytes<'a>

Blanket Implementations

impl<T> Any for T where
T: 'static + ?Sized,

pub fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

impl<T> Borrow<T> for T where
T: ?Sized,

const: unstable · source

pub fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for T where
T: ?Sized,

const: unstable · source

pub fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

impl<T> From<T> for T

const: unstable · source

pub fn from(t: T) -> T

Returns the argument unchanged.

impl<T, U> Into<U> for T where
U: From<T>,

const: unstable · source

pub fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

impl<T> ToOwned for T where
T: Clone,

type Owned = T

The resulting type after obtaining ownership.

pub fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more

pub fn clone_into(&self, target: &mut T)

🔬 This is a nightly-only experimental API. (toowned_clone_into)

Uses borrowed data to replace owned data, usually by cloning. Read more

impl<T, U> TryFrom<U> for T where
U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

const: unstable · source

pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.

impl<T, U> TryInto<U> for T where
U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

const: unstable · source

pub fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.

impl<T> DeserializeOwned for T where
T: for<'de> Deserialize<'de>,