Struct SingularPtrField

pub struct SingularPtrField<T> { /* private fields */ }

Like Option<Box<T>>, but keeps the actual element on clear.

Implementations

impl<T> SingularPtrField<T>

pub fn some(value: T) -> SingularPtrField<T>

Construct SingularPtrField from given object.

pub fn none() -> SingularPtrField<T>

Construct an empty SingularPtrField.

pub fn from_option(option: Option<T>) -> SingularPtrField<T>

Construct SingularPtrField from optional.

pub fn is_some(&self) -> bool

True iff this object contains data.

pub fn is_none(&self) -> bool

True iff this object contains no data.

pub fn into_option(self) -> Option<T>

Convert into Option<T>.

pub fn as_ref<'a>(&'a self) -> Option<&'a T>

View data as reference option.

pub fn as_mut<'a>(&'a mut self) -> Option<&'a mut T>

View data as mutable reference option.

pub fn get_ref<'a>(&'a self) -> &'a T

Get data as reference. Panics if empty.

pub fn get_mut_ref<'a>(&'a mut self) -> &'a mut T

Get data as mutable reference. Panics if empty.

pub fn unwrap(self) -> T

Take the data. Panics if empty

pub fn unwrap_or(self, def: T) -> T

Take the data or return supplied default element if empty.

pub fn unwrap_or_else<F>(self, f: F) -> T

where F: FnOnce() -> T,

Take the data or return supplied default element if empty.

pub fn map<U, F>(self, f: F) -> SingularPtrField<U>

where F: FnOnce(T) -> U,

Apply given function to contained data to construct another SingularPtrField. Returns empty SingularPtrField if this object is empty.

pub fn iter<'a>(&'a self) -> IntoIter<&'a T>

View data as iterator.

pub fn mut_iter<'a>(&'a mut self) -> IntoIter<&'a mut T>

View data as mutable iterator.

pub fn take(&mut self) -> Option<T>

Take data as option, leaving this object empty.

pub fn clear(&mut self)

Clear this object, but do not call destructor of underlying data.

impl<T: Default + Clear> SingularPtrField<T>

pub fn unwrap_or_default(self) -> T

Get contained data, consume self. Return default value for type if this is empty.

pub fn set_default<'a>(&'a mut self) -> &'a mut T

Initialize this object with default value. This operation can be more efficient then construction of clear element, because it may reuse previously contained object.

Trait Implementations

impl<T: Clone> Clone for SingularPtrField<T>

fn clone(&self) -> SingularPtrField<T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for SingularPtrField<T>

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

Formats the value using the given formatter.

impl<T> Default for SingularPtrField<T>

fn default() -> SingularPtrField<T>

Returns the “default value” for a type.

impl<T> From<Option<T>> for SingularPtrField<T>

fn from(o: Option<T>) -> Self

Converts to this type from the input type.

impl<T: Hash> Hash for SingularPtrField<T>

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<'a, T> IntoIterator for &'a SingularPtrField<T>

type Item = &'a T

The type of the elements being iterated over.

type IntoIter = IntoIter<&'a T>

Which kind of iterator are we turning this into?

fn into_iter(self) -> IntoIter<&'a T>

Creates an iterator from a value.

impl<T: PartialEq> PartialEq for SingularPtrField<T>

fn eq(&self, other: &SingularPtrField<T>) -> 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: Eq> Eq for SingularPtrField<T>