[−][src]Struct compact::COption
A wrapper to make an Option
of a nontrivial Compact
possible.
Unfortunately, we can't blanket-impl
that, since that overlaps
(for the compiler) with the impl
for trivial Copy
types...
Methods from Deref<Target = Option<T>>
#[must_use]
pub fn is_some(&self) -> bool
1.0.0[src]
Returns true
if the option is a Some
value.
Examples
let x: Option<u32> = Some(2); assert_eq!(x.is_some(), true); let x: Option<u32> = None; assert_eq!(x.is_some(), false);
#[must_use]
pub fn is_none(&self) -> bool
1.0.0[src]
Returns true
if the option is a None
value.
Examples
let x: Option<u32> = Some(2); assert_eq!(x.is_none(), false); let x: Option<u32> = None; assert_eq!(x.is_none(), true);
pub fn as_ref(&self) -> Option<&T>
1.0.0[src]
Converts from &Option<T>
to Option<&T>
.
Examples
Converts an Option<
String
>
into an Option<
usize
>
, preserving the original.
The map
method takes the self
argument by value, consuming the original,
so this technique uses as_ref
to first take an Option
to a reference
to the value inside the original.
let text: Option<String> = Some("Hello, world!".to_string()); // First, cast `Option<String>` to `Option<&String>` with `as_ref`, // then consume *that* with `map`, leaving `text` on the stack. let text_length: Option<usize> = text.as_ref().map(|s| s.len()); println!("still can print text: {:?}", text);
pub fn as_mut(&mut self) -> Option<&mut T>
1.0.0[src]
Converts from &mut Option<T>
to Option<&mut T>
.
Examples
let mut x = Some(2); match x.as_mut() { Some(v) => *v = 42, None => {}, } assert_eq!(x, Some(42));
pub fn as_pin_ref(self: Pin<&'a Option<T>>) -> Option<Pin<&'a T>>
1.33.0[src]
Converts from Pin<&Option<T>>
to Option<Pin<&T>>
pub fn as_pin_mut(self: Pin<&'a mut Option<T>>) -> Option<Pin<&'a mut T>>
1.33.0[src]
Converts from Pin<&mut Option<T>>
to Option<Pin<&mut T>>
pub fn iter(&self) -> Iter<T>
1.0.0[src]
Returns an iterator over the possibly contained value.
Examples
let x = Some(4); assert_eq!(x.iter().next(), Some(&4)); let x: Option<u32> = None; assert_eq!(x.iter().next(), None);
pub fn iter_mut(&mut self) -> IterMut<T>
1.0.0[src]
Returns a mutable iterator over the possibly contained value.
Examples
let mut x = Some(4); match x.iter_mut().next() { Some(v) => *v = 42, None => {}, } assert_eq!(x, Some(42)); let mut x: Option<u32> = None; assert_eq!(x.iter_mut().next(), None);
pub fn get_or_insert(&mut self, v: T) -> &mut T
1.20.0[src]
Inserts v
into the option if it is None
, then
returns a mutable reference to the contained value.
Examples
let mut x = None; { let y: &mut u32 = x.get_or_insert(5); assert_eq!(y, &5); *y = 7; } assert_eq!(x, Some(7));
pub fn get_or_insert_with<F>(&mut self, f: F) -> &mut T where
F: FnOnce() -> T,
1.20.0[src]
F: FnOnce() -> T,
Inserts a value computed from f
into the option if it is None
, then
returns a mutable reference to the contained value.
Examples
let mut x = None; { let y: &mut u32 = x.get_or_insert_with(|| 5); assert_eq!(y, &5); *y = 7; } assert_eq!(x, Some(7));
pub fn take(&mut self) -> Option<T>
1.0.0[src]
Takes the value out of the option, leaving a None
in its place.
Examples
let mut x = Some(2); let y = x.take(); assert_eq!(x, None); assert_eq!(y, Some(2)); let mut x: Option<u32> = None; let y = x.take(); assert_eq!(x, None); assert_eq!(y, None);
pub fn replace(&mut self, value: T) -> Option<T>
1.31.0[src]
Replaces the actual value in the option by the value given in parameter,
returning the old value if present,
leaving a Some
in its place without deinitializing either one.
Examples
let mut x = Some(2); let old = x.replace(5); assert_eq!(x, Some(5)); assert_eq!(old, Some(2)); let mut x = None; let old = x.replace(3); assert_eq!(x, Some(3)); assert_eq!(old, None);
pub fn deref(&self) -> Option<&<T as Deref>::Target>
[src]
🔬 This is a nightly-only experimental API. (inner_deref
)
newly added
Converts from &Option<T>
to Option<&T::Target>
.
Leaves the original Option in-place, creating a new one with a reference
to the original one, additionally coercing the contents via Deref
.
Trait Implementations
impl<T: Clone + Compact> Compact for CompactOption<T>
[src]
fn is_still_compact(&self) -> bool
[src]
fn dynamic_size_bytes(&self) -> usize
[src]
unsafe fn compact(source: *mut Self, dest: *mut Self, new_dynamic_part: *mut u8)
[src]
unsafe fn decompact(source: *const Self) -> Self
[src]
fn total_size_bytes(&self) -> usize
[src]
Total size of the object (static part + dynamic part)
unsafe fn behind(ptr: *mut Self) -> *mut u8
[src]
Get a pointer to behind the static part of self
(commonly used place for the dynamic part)
unsafe fn compact_behind(source: *mut Self, dest: *mut Self)
[src]
Like compact
with new_dynamic_part
set to dest.behind()
impl<T: Default + Compact + Clone> Default for CompactOption<T>
[src]
fn default() -> CompactOption<T>
[src]
impl<T: Clone + Compact> Clone for CompactOption<T>
[src]
fn clone(&self) -> CompactOption<T>
[src]
fn clone_from(&mut self, source: &Self)
1.0.0[src]
Performs copy-assignment from source
. Read more
impl<T: Compact + Clone> DerefMut for CompactOption<T>
[src]
impl<T: Compact + Clone> Deref for CompactOption<T>
[src]
impl<T: Debug + Compact + Clone> Debug for CompactOption<T>
[src]
Auto Trait Implementations
impl<T> Sync for CompactOption<T> where
T: Sync,
T: Sync,
impl<T> Send for CompactOption<T> where
T: Send,
T: Send,
impl<T> Unpin for CompactOption<T> where
T: Unpin,
T: Unpin,
impl<T> RefUnwindSafe for CompactOption<T> where
T: RefUnwindSafe,
T: RefUnwindSafe,
impl<T> UnwindSafe for CompactOption<T> where
T: UnwindSafe,
T: UnwindSafe,
Blanket Implementations
impl<T, U> Into<U> for T where
U: From<T>,
[src]
U: From<T>,
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> From<T> for T
[src]
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> BorrowMut<T> for T where
T: ?Sized,
[src]
T: ?Sized,
fn borrow_mut(&mut self) -> &mut T
[src]
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,