Type Alias ApisVec

pub type ApisVec = Cow<'static, [(ApiId, u32)]>;

A vector of pairs of ApiId and a u32 for version.

Aliased Type

enum ApisVec {
    Borrowed(&'static [([u8; 8], u32)]),
    Owned(Vec<([u8; 8], u32)>),
}

Variants

Borrowed(&'static [([u8; 8], u32)])

Borrowed data.

Owned(Vec<([u8; 8], u32)>)

Owned data.

Implementations

impl<B> Cow<'_, B>

where B: ToOwned + ?Sized,

pub const 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 const 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());

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>
);

pub fn into_owned(self) -> <B as ToOwned>::Owned

Extracts the owned data.

Clones the data if it is not already owned.

Examples

Calling into_owned on a Cow::Borrowed returns a clone of the borrowed data:

use std::borrow::Cow;

let s = "Hello world!";
let cow = Cow::Borrowed(s);

assert_eq!(
  cow.into_owned(),
  String::from(s)
);

Calling into_owned on a Cow::Owned returns the owned data. The data is moved out of the Cow without being cloned.

use std::borrow::Cow;

let s = "Hello world!";
let cow: Cow<'_, str> = Cow::Owned(String::from(s));

assert_eq!(
  cow.into_owned(),
  String::from(s)
);

Trait Implementations

impl<'a, A> Arbitrary<'a> for Cow<'a, A>

where A: ToOwned + ?Sized, <A as ToOwned>::Owned: Arbitrary<'a>,

fn arbitrary(u: &mut Unstructured<'a>) -> Result<Cow<'a, A>, Error>

Generate an arbitrary value of Self from the given unstructured data.

fn size_hint(depth: usize) -> (usize, Option<usize>)

Get a size hint for how many bytes out of an Unstructured this type needs to construct itself.

fn arbitrary_take_rest(u: Unstructured<'a>) -> Result<Self, Error>

Generate an arbitrary value of Self from the entirety of the given unstructured data.

impl<T> AsRef<T> for Cow<'_, T>

where T: ToOwned + ?Sized,

fn as_ref(&self) -> &T

Converts this type into a shared reference of the (usually inferred) input type.

impl<'a, B> Borrow<B> for Cow<'a, B>

where B: ToOwned + ?Sized,

fn borrow(&self) -> &B

Immutably borrows from an owned value.

impl<'a, T> CanonicalDeserialize for Cow<'a, T>

where T: ToOwned + Valid + Sync + Send, <T as ToOwned>::Owned: CanonicalDeserialize + Valid + Send,

fn deserialize_with_mode<R>( reader: R, compress: Compress, validate: Validate, ) -> Result<Cow<'a, T>, SerializationError>

where R: Read,

The general deserialize method that takes in customization flags.

fn deserialize_compressed<R>(reader: R) -> Result<Self, SerializationError>

where R: Read,

fn deserialize_compressed_unchecked<R>( reader: R, ) -> Result<Self, SerializationError>

where R: Read,

fn deserialize_uncompressed<R>(reader: R) -> Result<Self, SerializationError>

where R: Read,

fn deserialize_uncompressed_unchecked<R>( reader: R, ) -> Result<Self, SerializationError>

where R: Read,

impl<'a, T> CanonicalSerialize for Cow<'a, T>

where T: CanonicalSerialize + ToOwned,

fn serialize_with_mode<W>( &self, writer: W, compress: Compress, ) -> Result<(), SerializationError>

where W: Write,

The general serialize method that takes in customization flags.

fn serialized_size(&self, compress: Compress) -> usize

fn serialize_compressed<W>(&self, writer: W) -> Result<(), SerializationError>

where W: Write,

fn compressed_size(&self) -> usize

fn serialize_uncompressed<W>(&self, writer: W) -> Result<(), SerializationError>

where W: Write,

fn uncompressed_size(&self) -> usize

impl<B> Clone for Cow<'_, B>

where B: ToOwned + ?Sized,

fn clone(&self) -> Cow<'_, B>

Returns a copy of the value.

fn clone_from(&mut self, source: &Cow<'_, B>)

Performs copy-assignment from source.

impl<B> Debug for Cow<'_, B>

where B: Debug + ToOwned + ?Sized, <B as ToOwned>::Owned: Debug,

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

Formats the value using the given formatter.

impl<T> Decode for Cow<'_, T>

where T: ToOwned + ?Sized, <T as ToOwned>::Owned: Decode,

fn decode<I>(input: &mut I) -> Result<Cow<'_, T>, Error>

where I: Input,

Attempt to deserialise the value from input.

fn decode_into<I>( input: &mut I, dst: &mut MaybeUninit<Self>, ) -> Result<DecodeFinished, Error>

where I: Input,

Attempt to deserialize the value from input into a pre-allocated piece of memory.

fn skip<I>(input: &mut I) -> Result<(), Error>

where I: Input,

Attempt to skip the encoded value from input.

fn encoded_fixed_size() -> Option<usize>

Returns the fixed encoded size of the type.

impl<B> Default for Cow<'_, B>

where B: ToOwned + ?Sized, <B as ToOwned>::Owned: Default,

fn default() -> Cow<'_, B>

Creates an owned Cow<’a, B> with the default value for the contained owned value.

impl<B> Deref for Cow<'_, B>

where B: ToOwned + ?Sized, <B as ToOwned>::Owned: Borrow<B>,

type Target = B

The resulting type after dereferencing.

fn deref(&self) -> &B

Dereferences the value.

impl<'de, 'a, T> Deserialize<'de> for Cow<'a, T>

where T: ToOwned + ?Sized, <T as ToOwned>::Owned: Deserialize<'de>,

fn deserialize<D>( deserializer: D, ) -> Result<Cow<'a, T>, <D as Deserializer<'de>>::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<B> Display for Cow<'_, B>

where B: Display + ToOwned + ?Sized, <B as ToOwned>::Owned: Display,

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

Formats the value using the given formatter.

impl<T> EncodeAsVarULE<T> for Cow<'_, T>

where T: VarULE + ToOwned + ?Sized,

fn encode_var_ule_as_slices<R>(&self, cb: impl FnOnce(&[&[u8]]) -> R) -> R

Calls cb with a piecewise list of byte slices that when concatenated produce the memory pattern of the corresponding instance of T.

fn encode_var_ule_len(&self) -> usize

Return the length, in bytes, of the corresponding [VarULE] type

fn encode_var_ule_write(&self, dst: &mut [u8])

Write the corresponding [VarULE] type to the dst buffer. dst should be the size of [Self::encode_var_ule_len()]

impl<'a, T> From<&'a [T]> for Cow<'a, [T]>

where T: Clone,

fn from(s: &'a [T]) -> Cow<'a, [T]>

Creates a Borrowed variant of Cow from a slice.

This conversion does not allocate or clone the data.

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

where T: Clone,

fn from(s: &'a [T; N]) -> Cow<'a, [T]>

Creates a Borrowed variant of Cow from a reference to an array.

This conversion does not allocate or clone the data.

impl<'a, T> From<&'a Vec<T>> for Cow<'a, [T]>

where T: Clone,

fn from(v: &'a Vec<T>) -> Cow<'a, [T]>

Creates a Borrowed variant of Cow from a reference to Vec.

This conversion does not allocate or clone the data.

impl<'a, T> From<Vec<T>> for Cow<'a, [T]>

where T: Clone,

fn from(v: Vec<T>) -> Cow<'a, [T]>

Creates an Owned variant of Cow from an owned instance of Vec.

This conversion does not allocate or clone the data.

impl<'a, T> FromIterator<T> for Cow<'a, [T]>

where T: Clone,

fn from_iter<I>(it: I) -> Cow<'a, [T]>

where I: IntoIterator<Item = T>,

Creates a value from an iterator.

impl<'a, C, T> FromParallelIterator<T> for Cow<'a, C>

where C: ToOwned + ?Sized, <C as ToOwned>::Owned: FromParallelIterator<T>, T: Send,

Collects an arbitrary Cow collection.

Note, the standard library only has FromIterator for Cow<'a, str> and Cow<'a, [T]>, because no one thought to add a blanket implementation before it was stabilized.

fn from_par_iter<I>(par_iter: I) -> Cow<'a, C>

where I: IntoParallelIterator<Item = T>,

Creates an instance of the collection from the parallel iterator par_iter.

impl<B> Hash for Cow<'_, B>

where B: Hash + ToOwned + ?Sized,

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

where H: Hasher,

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<'a, T> JsonSchema for Cow<'a, T>

where T: ToOwned + JsonSchema + ?Sized,

fn is_referenceable() -> bool

Whether JSON Schemas generated for this type should be re-used where possible using the $ref keyword.

fn schema_name() -> String

The name of the generated JSON Schema.

fn json_schema(gen: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

impl<B> Ord for Cow<'_, B>

where B: Ord + ToOwned + ?Sized,

fn cmp(&self, other: &Cow<'_, B>) -> Ordering

This method returns an Ordering between self and other.

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

where Self: Sized,

Compares and returns the maximum of two values.

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

where Self: Sized,

Compares and returns the minimum of two values.

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

where Self: Sized,

Restrict a value to a certain interval.

impl<T, U> PartialEq<&[U]> for Cow<'_, [T]>

where T: PartialEq<U> + Clone,

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

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &&[U]) -> bool

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

impl<T, U> PartialEq<&mut [U]> for Cow<'_, [T]>

where T: PartialEq<U> + Clone,

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

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &&mut [U]) -> bool

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

impl<'a, 'b, B, C> PartialEq<Cow<'b, C>> for Cow<'a, B>

where B: PartialEq<C> + ToOwned + ?Sized, C: ToOwned + ?Sized,

fn eq(&self, other: &Cow<'b, C>) -> bool

Tests for self and other values to be equal, and is used by ==.

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

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

impl<T, U, A> PartialEq<Vec<U, A>> for Cow<'_, [T]>

where A: Allocator, T: PartialEq<U> + Clone,

fn eq(&self, other: &Vec<U, A>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Vec<U, A>) -> bool

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

impl<T, U, A> PartialEq<Vec<U, A>> for Cow<'_, [T]>

where A: Allocator, T: PartialEq<U> + Clone,

fn eq(&self, other: &Vec<U, A>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Vec<U, A>) -> bool

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

impl<'a, B> PartialOrd for Cow<'a, B>

where B: PartialOrd + ToOwned + ?Sized,

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

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

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl<'a, T> Serialize for Cow<'a, T>

where T: Serialize + ToOwned + ?Sized,

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

where S: Serializer,

Serialize this value into the given Serde serializer.

impl<T> TypeInfo for Cow<'static, T>

where T: ToOwned + TypeInfo + 'static + ?Sized,

type Identity = Cow<'static, T>

The type identifying for which type info is provided.

fn type_info() -> Type

Returns the static type identifier for Self.

impl<'b, T> Valid for Cow<'b, T>

where T: ToOwned + Sync + Valid + Send, <T as ToOwned>::Owned: CanonicalDeserialize + Send,

fn check(&self) -> Result<(), SerializationError>

fn batch_check<'a>( batch: impl Iterator<Item = &'a Cow<'b, T>> + Send, ) -> Result<(), SerializationError>

where Cow<'b, T>: 'a,

impl<'a, T> Writeable for Cow<'a, T>

where T: Writeable + ToOwned + ?Sized,

fn write_to<W>(&self, sink: &mut W) -> Result<(), Error>

where W: Write + ?Sized,

Writes a string to the given sink. Errors from the sink are bubbled up. The default implementation delegates to write_to_parts, and discards any Part annotations.

fn write_to_parts<W>(&self, sink: &mut W) -> Result<(), Error>

where W: PartsWrite + ?Sized,

Write bytes and Part annotations to the given sink. Errors from the sink are bubbled up. The default implementation delegates to write_to, and doesn’t produce any Part annotations.

fn writeable_length_hint(&self) -> LengthHint

Returns a hint for the number of UTF-8 bytes that will be written to the sink.

fn write_to_string(&self) -> Cow<'_, str>

Creates a new String with the data from this Writeable. Like ToString, but smaller and faster.

fn writeable_cmp_bytes(&self, other: &[u8]) -> Ordering

Compares the contents of this Writeable to the given bytes without allocating a String to hold the Writeable contents.

impl<'a, T> Yokeable<'a> for Cow<'static, T>

where T: 'static + ToOwned + ?Sized, <T as ToOwned>::Owned: Sized,

type Output = Cow<'a, T>

This type MUST be Self with the 'static replaced with 'a, i.e. Self<'a>

fn transform(&'a self) -> &'a Cow<'a, T>

This method must cast self between &'a Self<'static> and &'a Self<'a>.

fn transform_owned(self) -> Cow<'a, T>

This method must cast self between Self<'static> and Self<'a>.

unsafe fn make(from: Cow<'a, T>) -> Cow<'static, T>

This method can be used to cast away Self<'a>’s lifetime.

fn transform_mut<F>(&'a mut self, f: F)

where F: 'static + for<'b> FnOnce(&'b mut <Cow<'static, T> as Yokeable<'a>>::Output),

This method must cast self between &'a mut Self<'static> and &'a mut Self<'a>, and pass it to f.

impl<'zf, B> ZeroFrom<'zf, Cow<'_, B>> for Cow<'zf, B>

where B: ToOwned + ?Sized,

fn zero_from(other: &'zf Cow<'_, B>) -> Cow<'zf, B>

Clone the other C into a struct that may retain references into C.

impl<'a, T> DecodeWithMemTracking for Cow<'a, T>

where T: ToOwned + DecodeWithMemTracking, Cow<'a, T>: Decode,

impl<B> DerefPure for Cow<'_, B>

where B: ToOwned + ?Sized, <B as ToOwned>::Owned: Borrow<B>,

impl<T> EncodeLike<T> for Cow<'_, T>

where T: ToOwned + Encode,

impl<T> EncodeLike for Cow<'_, T>

where T: ToOwned + Encode + ?Sized,

impl<B> Eq for Cow<'_, B>

where B: Eq + ToOwned + ?Sized,

impl<T> WrapperTypeEncode for Cow<'_, T>

where T: ToOwned + ?Sized,