[−][src]Enum abi_stable::std_types::cow::RCow
Ffi-safe equivalent of ::std::borrow::Cow.
The most common examples of this type are:
-
RCow<'_,str>
: contains an RStr<'_> or an RString. -
RCow<'_,[T]>
: contains an RSlice<'_,T> or an RVec. -
RCow<'_,T>
: contains a&T
or aT
.
Example
Using a RCow<'a,str>
.
This implements a solution to the well known fizzbuzz problem.
use abi_stable::std_types::RCow; fn fizzbuzz(n:u32)->RCow<'static,str>{ match (n%3,n%5) { (0,0)=>RCow::from("FizzBuzz"), (0,_)=>RCow::from("Fizz"), (_,0)=>RCow::from("Buzz"), (_,_)=>RCow::from(n.to_string()), } } for n in 1..=100{ println!("{}",fizzbuzz(n)); }
Note:this example allocates when the number is neither a multiple of 5 or 3.
Variants
Borrowed(<B as BorrowOwned<'a>>::RBorrowed)
Owned(<B as BorrowOwned<'a>>::ROwned)
Methods
impl<'a, B: ?Sized> RCow<'a, B> where
B: BorrowOwned<'a>,
[src]
B: BorrowOwned<'a>,
pub fn to_mut(&mut self) -> &mut B::ROwned
[src]
Get a mutable reference to the owner form of RCow, converting to the owned form if it is currently the borrowed form.
Examples
use abi_stable::std_types::RCow; let mut cow:RCow<'_,str>=RCow::from("Hello"); assert_eq!(&*cow,"Hello"); assert!(cow.is_borrowed()); cow.to_mut().push_str(", world!"); assert!(cow.is_owned()); assert_eq!(cow,RCow::from("Hello, world!"));
pub fn into_owned(self) -> B::ROwned
[src]
Unwraps into the owned owner form of RCow, converting to the owned form if it is currently the borrowed form.
Examples
use abi_stable::std_types::RCow; let mut cow:RCow<'_,str>=RCow::from("Hello"); assert_eq!(&*cow,"Hello"); let mut buff=cow.into_owned(); buff.push_str(", world!"); assert_eq!(&*buff,"Hello, world!");
pub fn borrowed<'b: 'a>(&'b self) -> <B as BorrowOwned<'b>>::RBorrowed
[src]
Gets the contents of the RCow casted to the borrowed variant.
Examples
use abi_stable::std_types::{RCow,RSlice}; { let cow:RCow<'_,[u8]>=RCow::from(&[0,1,2,3][..]); assert_eq!( cow.borrowed(), RSlice::from_slice(&[0,1,2,3]) ); } { let cow:RCow<'_,[u8]>=RCow::from(vec![0,1,2,3]); assert_eq!( cow.borrowed(), RSlice::from_slice(&[0,1,2,3]) ); }
pub fn is_borrowed(&self) -> bool
[src]
Whether this is a borrowing RCow.
Examples
use abi_stable::std_types::RCow; { let cow:RCow<'_,[u8]>=RCow::from(&[0,1,2,3][..]); assert!( cow.is_borrowed() ); } { let cow:RCow<'_,[u8]>=RCow::from(vec![0,1,2,3]); assert!( !cow.is_borrowed() ); }
pub fn is_owned(&self) -> bool
[src]
Whether this is an owning RCow.
Examples
use abi_stable::std_types::RCow; let cow:RCow<'_,[u8]>=RCow::from(&[0,1,2,3][..]); assert!( !cow.is_owned() ); let cow:RCow<'_,[u8]>=RCow::from(vec![0,1,2,3]); assert!( cow.is_owned() );
impl<'a, T> RCow<'a, [T]> where
T: Clone,
[src]
T: Clone,
pub fn from_slice(this: &'a [T]) -> Self
[src]
For converting a &'a [T]
to an RCow<'a,[T]>
,
most useful when converting from &'a [T;N]
because it coerces the array to a slice.
Trait Implementations
impl<'a, B: ?Sized> IntoReprRust for RCow<'a, B> where
B: BorrowOwned<'a>,
[src]
B: BorrowOwned<'a>,
impl<'a, B: ?Sized> GetStaticEquivalent_ for RCow<'a, B> where
B: BorrowOwned<'a>,
B: __GetStaticEquivalent_,
<B as BorrowOwned<'a>>::RBorrowed: StableAbi,
<B as BorrowOwned<'a>>::ROwned: StableAbi,
[src]
B: BorrowOwned<'a>,
B: __GetStaticEquivalent_,
<B as BorrowOwned<'a>>::RBorrowed: StableAbi,
<B as BorrowOwned<'a>>::ROwned: StableAbi,
type StaticEquivalent = _static_RCow<'static, __GetStaticEquivalent<B>>
impl<'a, B: ?Sized> SharedStableAbi for RCow<'a, B> where
B: BorrowOwned<'a>,
B: __GetStaticEquivalent_,
<B as BorrowOwned<'a>>::RBorrowed: StableAbi,
<B as BorrowOwned<'a>>::ROwned: StableAbi,
[src]
B: BorrowOwned<'a>,
B: __GetStaticEquivalent_,
<B as BorrowOwned<'a>>::RBorrowed: StableAbi,
<B as BorrowOwned<'a>>::ROwned: StableAbi,
type IsNonZeroType = False
Whether this type has a single invalid bit-pattern. Read more
type Kind = __ValueKind
The kind of abi stability of this type,there are 2: Read more
const S_LAYOUT: &'static TypeLayout
[src]
const S_ABI_CONSTS: AbiConsts
[src]
impl<'a, B: ?Sized> AsRef<B> for RCow<'a, B> where
B: BorrowOwned<'a>,
[src]
B: BorrowOwned<'a>,
impl<'a, B: ?Sized> Into<Cow<'a, B>> for RCow<'a, B> where
B: BorrowOwned<'a>,
[src]
B: BorrowOwned<'a>,
impl<'a, B: ?Sized> From<Cow<'a, B>> for RCow<'a, B> where
B: BorrowOwned<'a>,
[src]
B: BorrowOwned<'a>,
impl<'a> From<&'a str> for RCow<'a, str>
[src]
impl<'a> From<RStr<'a>> for RCow<'a, str>
[src]
impl<'a> From<String> for RCow<'a, str>
[src]
impl<'a> From<&'a String> for RCow<'a, str>
[src]
impl<'a> From<RString> for RCow<'a, str>
[src]
impl<'a> From<&'a RString> for RCow<'a, str>
[src]
impl<'a, T> From<&'a [T]> for RCow<'a, [T]> where
T: Clone,
[src]
T: Clone,
impl<'a, T> From<RSlice<'a, T>> for RCow<'a, [T]> where
T: Clone,
[src]
T: Clone,
impl<'a, T> From<Vec<T>> for RCow<'a, [T]> where
T: Clone,
[src]
T: Clone,
impl<'a, T> From<RVec<T>> for RCow<'a, [T]> where
T: Clone,
[src]
T: Clone,
impl<'a, B: ?Sized> Clone for RCow<'a, B> where
B: BorrowOwned<'a>,
B::ROwned: Clone,
[src]
B: BorrowOwned<'a>,
B::ROwned: Clone,
fn clone(&self) -> Self
[src]
fn clone_from(&mut self, source: &Self)
1.0.0[src]
impl<'a, B: ?Sized> Copy for RCow<'a, B> where
B: BorrowOwned<'a>,
B::ROwned: Copy,
[src]
B: BorrowOwned<'a>,
B::ROwned: Copy,
impl<'a, B: ?Sized> Eq for RCow<'a, B> where
B: Eq,
B: BorrowOwned<'a>,
[src]
B: Eq,
B: BorrowOwned<'a>,
impl<'a, B: ?Sized> Ord for RCow<'a, B> where
B: Ord,
B: BorrowOwned<'a>,
[src]
B: Ord,
B: BorrowOwned<'a>,
fn cmp(&self, other: &Self) -> Ordering
[src]
fn max(self, other: Self) -> Self
1.21.0[src]
fn min(self, other: Self) -> Self
1.21.0[src]
fn clamp(self, min: Self, max: Self) -> Self
[src]
impl<'a, B: ?Sized> PartialEq<RCow<'a, B>> for RCow<'a, B> where
B: PartialEq,
B: BorrowOwned<'a>,
[src]
B: PartialEq,
B: BorrowOwned<'a>,
impl<'a, B: ?Sized> PartialOrd<RCow<'a, B>> for RCow<'a, B> where
B: PartialOrd,
B: BorrowOwned<'a>,
[src]
B: PartialOrd,
B: BorrowOwned<'a>,
fn partial_cmp(&self, other: &Self) -> Option<Ordering>
[src]
#[must_use]
fn lt(&self, other: &Rhs) -> bool
1.0.0[src]
#[must_use]
fn le(&self, other: &Rhs) -> bool
1.0.0[src]
#[must_use]
fn gt(&self, other: &Rhs) -> bool
1.0.0[src]
#[must_use]
fn ge(&self, other: &Rhs) -> bool
1.0.0[src]
impl<'a, B: ?Sized> Display for RCow<'a, B> where
B: BorrowOwned<'a>,
B: Display,
[src]
B: BorrowOwned<'a>,
B: Display,
impl<'a, B: ?Sized> Debug for RCow<'a, B> where
B: Debug,
B: BorrowOwned<'a>,
[src]
B: Debug,
B: BorrowOwned<'a>,
impl<'a, B: ?Sized> Deref for RCow<'a, B> where
B: BorrowOwned<'a>,
[src]
B: BorrowOwned<'a>,
impl<'a, B: ?Sized> Hash for RCow<'a, B> where
B: Hash,
B: BorrowOwned<'a>,
[src]
B: Hash,
B: BorrowOwned<'a>,
fn hash<H>(&self, state: &mut H) where
H: Hasher,
[src]
H: Hasher,
fn hash_slice<H>(data: &[Self], state: &mut H) where
H: Hasher,
1.3.0[src]
H: Hasher,
impl<'a, B: ?Sized> Borrow<B> for RCow<'a, B> where
B: BorrowOwned<'a>,
[src]
B: BorrowOwned<'a>,
impl<'de, 'a, T> Deserialize<'de> for RCow<'a, [T]> where
T: Clone + Deserialize<'de>,
[src]
T: Clone + Deserialize<'de>,
fn deserialize<D>(deserializer: D) -> Result<Self, D::Error> where
D: Deserializer<'de>,
[src]
D: Deserializer<'de>,
impl<'de, 'a> Deserialize<'de> for RCow<'a, str>
[src]
fn deserialize<D>(deserializer: D) -> Result<Self, D::Error> where
D: Deserializer<'de>,
[src]
D: Deserializer<'de>,
impl<'de, 'a, T> Deserialize<'de> for RCow<'a, T> where
T: Clone + Deserialize<'de>,
[src]
T: Clone + Deserialize<'de>,
fn deserialize<D>(deserializer: D) -> Result<Self, D::Error> where
D: Deserializer<'de>,
[src]
D: Deserializer<'de>,
impl<'a, B: ?Sized> Serialize for RCow<'a, B> where
B: BorrowOwned<'a>,
B: Serialize,
[src]
B: BorrowOwned<'a>,
B: Serialize,
Auto Trait Implementations
impl<'a, B: ?Sized> Send for RCow<'a, B> where
<B as BorrowOwned<'a>>::RBorrowed: Send,
<B as BorrowOwned<'a>>::ROwned: Send,
<B as BorrowOwned<'a>>::RBorrowed: Send,
<B as BorrowOwned<'a>>::ROwned: Send,
impl<'a, B: ?Sized> Sync for RCow<'a, B> where
<B as BorrowOwned<'a>>::RBorrowed: Sync,
<B as BorrowOwned<'a>>::ROwned: Sync,
<B as BorrowOwned<'a>>::RBorrowed: Sync,
<B as BorrowOwned<'a>>::ROwned: Sync,
impl<'a, B: ?Sized> Unpin for RCow<'a, B> where
<B as BorrowOwned<'a>>::RBorrowed: Unpin,
<B as BorrowOwned<'a>>::ROwned: Unpin,
<B as BorrowOwned<'a>>::RBorrowed: Unpin,
<B as BorrowOwned<'a>>::ROwned: Unpin,
impl<'a, B: ?Sized> UnwindSafe for RCow<'a, B> where
<B as BorrowOwned<'a>>::RBorrowed: UnwindSafe,
<B as BorrowOwned<'a>>::ROwned: UnwindSafe,
<B as BorrowOwned<'a>>::RBorrowed: UnwindSafe,
<B as BorrowOwned<'a>>::ROwned: UnwindSafe,
impl<'a, B: ?Sized> RefUnwindSafe for RCow<'a, B> where
<B as BorrowOwned<'a>>::RBorrowed: RefUnwindSafe,
<B as BorrowOwned<'a>>::ROwned: RefUnwindSafe,
<B as BorrowOwned<'a>>::RBorrowed: RefUnwindSafe,
<B as BorrowOwned<'a>>::ROwned: RefUnwindSafe,
Blanket Implementations
impl<This> GetConstGenericVTable for This where
This: StableAbi + Eq + PartialEq<This> + Debug + Send + Sync,
[src]
This: StableAbi + Eq + PartialEq<This> + Debug + Send + Sync,
const VTABLE: ConstGenericVTableFor<This>
[src]
impl<This> StableAbi for This where
This: SharedStableAbi<Kind = ValueKind>,
[src]
This: SharedStableAbi<Kind = ValueKind>,
const LAYOUT: &'static TypeLayout
[src]
const ABI_CONSTS: AbiConsts
[src]
impl<This> TransmuteElement for This where
This: ?Sized,
[src]
This: ?Sized,
unsafe fn transmute_element<T>(self) -> Self::TransmutedPtr where
Self: CanTransmuteElement<T>,
Self::Target: Sized,
[src]
Self: CanTransmuteElement<T>,
Self::Target: Sized,
impl<'a, T> BorrowOwned<'a> for T where
T: 'a + Clone,
[src]
T: 'a + Clone,
type ROwned = T
type RBorrowed = &'a T
fn r_borrow(
&'a <T as BorrowOwned<'a>>::ROwned
) -> <T as BorrowOwned<'a>>::RBorrowed
[src]
&'a <T as BorrowOwned<'a>>::ROwned
) -> <T as BorrowOwned<'a>>::RBorrowed
fn r_to_owned(
<T as BorrowOwned<'a>>::RBorrowed
) -> <T as BorrowOwned<'a>>::ROwned
[src]
<T as BorrowOwned<'a>>::RBorrowed
) -> <T as BorrowOwned<'a>>::ROwned
fn deref_borrowed(&<T as BorrowOwned<'a>>::RBorrowed) -> &T
[src]
fn deref_owned(&<T as BorrowOwned<'a>>::ROwned) -> &T
[src]
fn from_cow_borrow(&'a T) -> <T as BorrowOwned<'a>>::RBorrowed
[src]
fn from_cow_owned(<T as ToOwned>::Owned) -> <T as BorrowOwned<'a>>::ROwned
[src]
fn into_cow_borrow(<T as BorrowOwned<'a>>::RBorrowed) -> &'a T
[src]
fn into_cow_owned(<T as BorrowOwned<'a>>::ROwned) -> <T as ToOwned>::Owned
[src]
impl<T, U> Into<U> for T where
U: From<T>,
[src]
U: From<T>,
impl<T> From<T> for T
[src]
impl<T> ToOwned for T where
T: Clone,
[src]
T: Clone,
type Owned = T
The resulting type after obtaining ownership.
fn to_owned(&self) -> T
[src]
fn clone_into(&self, target: &mut T)
[src]
impl<T> ToString for T where
T: Display + ?Sized,
[src]
T: Display + ?Sized,
impl<T, U> TryFrom<U> for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,
type Error = <U as TryFrom<T>>::Error
The type returned in the event of a conversion error.
fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>
[src]
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
T: ?Sized,
fn borrow_mut(&mut self) -> &mut T
[src]
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,
impl<T> TypeIdentity for T where
T: ?Sized,
[src]
T: ?Sized,
type Type = T
The same type as Self. Read more
fn into_type_val(self) -> Self::Type where
Self::Type: Sized,
[src]
Self::Type: Sized,
fn into_type_ref(&self) -> &Self::Type
[src]
fn into_type_mut(&mut self) -> &mut Self::Type
[src]
fn into_type_box(self: Box<Self>) -> Box<Self::Type>
[src]
fn into_type_arc(this: Arc<Self>) -> Arc<Self::Type>
[src]
fn into_type_rc(this: Rc<Self>) -> Rc<Self::Type>
[src]
fn from_type_val(this: Self::Type) -> Self where
Self::Type: Sized,
[src]
Self::Type: Sized,
fn from_type_ref(this: &Self::Type) -> &Self
[src]
fn from_type_mut(this: &mut Self::Type) -> &mut Self
[src]
fn from_type_box(this: Box<Self::Type>) -> Box<Self>
[src]
fn from_type_arc(this: Arc<Self::Type>) -> Arc<Self>
[src]
fn from_type_rc(this: Rc<Self::Type>) -> Rc<Self>
[src]
impl<T> SelfOps for T where
T: ?Sized,
[src]
T: ?Sized,
const T: PhantomData<fn() -> Self>
[src]
const T_D: PhantomData<Self>
[src]
fn assert_ty(self, _other: PhantomData<fn() -> Self>) -> Self
[src]
fn assert_ty_ref(&self, _other: PhantomData<fn() -> Self>) -> &Self
[src]
fn assert_ty_mut(&mut self, _other: PhantomData<fn() -> Self>) -> &mut Self
[src]
fn ty_(&self) -> PhantomData<fn() -> Self>
[src]
fn ty_d(&self) -> PhantomData<Self>
[src]
fn ty_inv(&self) -> PhantomData<fn(Self) -> Self>
[src]
fn ty_inv_ref(&self) -> PhantomData<Cell<&Self>>
[src]
fn eq_id(&self, other: &Self) -> bool
[src]
fn piped<F, U>(self, f: F) -> U where
F: FnOnce(Self) -> U,
[src]
F: FnOnce(Self) -> U,
fn piped_ref<'a, F, U>(&'a self, f: F) -> U where
F: FnOnce(&'a Self) -> U,
[src]
F: FnOnce(&'a Self) -> U,
fn piped_mut<'a, F, U>(&'a mut self, f: F) -> U where
F: FnOnce(&'a mut Self) -> U,
[src]
F: FnOnce(&'a mut Self) -> U,
fn mutated<F>(self, f: F) -> Self where
F: FnOnce(&mut Self),
[src]
F: FnOnce(&mut Self),
fn observe<F>(self, f: F) -> Self where
F: FnOnce(&Self),
[src]
F: FnOnce(&Self),
fn into_<T>(self, PhantomData<fn() -> T>) -> T where
Self: Into<T>,
[src]
Self: Into<T>,
fn as_ref_<T>(&self) -> &T where
Self: AsRef<T>,
T: ?Sized,
[src]
Self: AsRef<T>,
T: ?Sized,
fn as_mut_<T>(&mut self) -> &mut T where
Self: AsMut<T>,
T: ?Sized,
[src]
Self: AsMut<T>,
T: ?Sized,
fn drop_(self)
[src]
impl<T> StringExt for T where
T: Borrow<str> + ?Sized,
[src]
T: Borrow<str> + ?Sized,
fn previous_char_boundary(&self, index: usize) -> usize
[src]
fn next_char_boundary(&self, index: usize) -> usize
[src]
fn left_char_boundary(&self, index: usize) -> usize
[src]
fn right_char_boundary(&self, index: usize) -> usize
[src]
fn get_offset_inside_of(&self, parent: &str) -> Option<usize>
[src]
fn offset_inside_of(&self, parent: &str) -> usize
[src]
fn is_substring_of(&self, parent: &str) -> bool
[src]
fn split_while<P, T>(&'a self, mapper: P) -> SplitWhile<'a, P, T> where
P: FnMut(char) -> T,
T: Eq + Clone,
[src]
P: FnMut(char) -> T,
T: Eq + Clone,
fn rsplit_while<P, T>(&'a self, mapper: P) -> RSplitWhile<'a, P, T> where
P: FnMut(char) -> T,
T: Eq + Clone,
[src]
P: FnMut(char) -> T,
T: Eq + Clone,
fn get_nth_char_index(&self, n: usize) -> Option<usize>
[src]
fn nth_char_index(&self, n: usize) -> usize
[src]
fn nth_char(&self, n: usize) -> Option<char>
[src]
fn first_chars(&self, n: usize) -> &str
[src]
fn last_chars(&self, n: usize) -> &str
[src]
fn from_nth_char(&self, n: usize) -> &str
[src]
fn calc_len_utf16(&self) -> usize
[src]
fn get_char_at(&self, at_byte: usize) -> Option<char>
[src]
fn char_indices_to(&self, to: usize) -> CharIndices
[src]
fn char_indices_from(&self, from: usize) -> CharIndicesFrom
[src]
fn left_pad(&self, how_much: usize) -> String
[src]
fn left_padder(&'a self, how_much: usize) -> LeftPadder<'a>
[src]
fn line_indentation(&self) -> usize
[src]
fn min_indentation(&self) -> usize
[src]
fn max_indentation(&self) -> usize
[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,
type Error = <U as TryFrom<T>>::Error
The error type returned when the conversion fails.
fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>
[src]
impl<T> DeserializeOwned for T where
T: Deserialize<'de>,
[src]
T: Deserialize<'de>,