Struct rental::examples::SimpleRefDeref

pub struct SimpleRefDeref { /* fields omitted */ }

Identical to SimpleRef, but with the deref_suffix flag enabled. This will provide a Deref impl for the struct, which will in turn deref the suffix. Notice that this flag also removes the self param from all methods, replacing it with an explicit param. This prevents any rental methods from blocking deref.

Methods

impl SimpleRefDeref

pub fn new<__Firef>(head: Box<i32>, iref: __Firef) -> Self where     __Firef: for<'head> FnOnce(&'head i32) -> &'head i32,

Create a new instance of the rental struct.

The first argument provided is the head, followed by a series of closures, one for each tail field. Each of these closures will receive, as its arguments, a borrow of the previous field, followed by borrows of the remaining prefix fields if the struct is a shared rental. If the struct is a mutable rental, only the immediately preceding field is passed.

pub fn try_new<__Firef, __E>(     head: Box<i32>,     iref: __Firef ) -> RentalResult<Self, __E, Box<i32>> where     __Firef: for<'head> FnOnce(&'head i32) -> Result<&'head i32, __E>,

Attempt to create a new instance of the rental struct.

As new, but each closure returns a Result. If one of them fails, execution is short-circuited and a tuple of the error and the original head value is returned to you.

pub fn try_new_or_drop<__Firef, __E>(     head: Box<i32>,     iref: __Firef ) -> Result<Self, __E> where     __Firef: for<'head> FnOnce(&'head i32) -> Result<&'head i32, __E>,

Attempt to create a new instance of the rental struct.

As try_new, but only the error value is returned upon failure; the head value is dropped. This method interacts more smoothly with existing error conversions.

pub unsafe fn all_erased(_self: &Self) -> Self::Borrow

Return lifetime-erased shared borrows of the fields of the struct.

This is unsafe because the erased lifetimes are fake. Use this only if absolutely necessary and be very mindful of what the true lifetimes are.

pub unsafe fn all_mut_erased(_self: &mut Self) -> Self::BorrowMut

Return a lifetime-erased mutable borrow of the suffix of the struct.

This is unsafe because the erased lifetimes are fake. Use this only if absolutely necessary and be very mindful of what the true lifetimes are.

pub fn rent<__F, __R>(_self: &Self, f: __F) -> __R where     __F: for<'iref, 'head> FnOnce(&'iref &'head i32) -> __R,     __R: ,

Execute a closure on the shared suffix of the struct.

The closure may return any value not bounded by one of the special rentail lifetimes of the struct.

pub fn rent_mut<__F, __R>(_self: &mut Self, f: __F) -> __R where     __F: for<'iref, 'head> FnOnce(&'iref mut &'head i32) -> __R,     __R: ,

Execute a closure on the mutable suffix of the struct.

The closure may return any value not bounded by one of the special rentail lifetimes of the struct.

Important traits for &'a mut R

impl<'a, R> Read for &'a mut R where
    R: Read + ?Sized, impl<'a, W> Write for &'a mut W where
    W: Write + ?Sized, impl<'a, I> Iterator for &'a mut I where
    I: Iterator + ?Sized,  type Item = <I as Iterator>::Item;

pub fn ref_rent<__F, __R>(_self: &Self, f: __F) -> &__R where     __F: for<'iref, 'head> FnOnce(&'iref &'head i32) -> &'iref __R,     __R: ?Sized,

Return a shared reference from the shared suffix of the struct.

This is a subtle variation of rent where it is legal to return a reference bounded by a rental lifetime, because that lifetime is reborrowed away before it is returned to you.

pub fn maybe_ref_rent<__F, __R>(_self: &Self, f: __F) -> Option<&__R> where     __F: for<'iref, 'head> FnOnce(&'iref &'head i32) -> Option<&'iref __R>,     __R: ?Sized,

Optionally return a shared reference from the shared suffix of the struct.

This is a subtle variation of rent where it is legal to return a reference bounded by a rental lifetime, because that lifetime is reborrowed away before it is returned to you.

pub fn try_ref_rent<__F, __R, __E>(_self: &Self, f: __F) -> Result<&__R, __E> where     __F: for<'iref, 'head> FnOnce(&'iref &'head i32) -> Result<&'iref __R, __E>,     __R: ?Sized,

Try to return a shared reference from the shared suffix of the struct, or an error on failure.

This is a subtle variation of rent where it is legal to return a reference bounded by a rental lifetime, because that lifetime is reborrowed away before it is returned to you.

Important traits for &'a mut R

impl<'a, R> Read for &'a mut R where
    R: Read + ?Sized, impl<'a, W> Write for &'a mut W where
    W: Write + ?Sized, impl<'a, I> Iterator for &'a mut I where
    I: Iterator + ?Sized,  type Item = <I as Iterator>::Item;

pub fn ref_rent_mut<__F, __R>(_self: &mut Self, f: __F) -> &mut __R where     __F: for<'iref, 'head> FnOnce(&'iref mut &'head i32) -> &'iref mut __R,     __R: ?Sized,

Return a mutable reference from the mutable suffix of the struct.

This is a subtle variation of rent_mut where it is legal to return a reference bounded by a rental lifetime, because that lifetime is reborrowed away before it is returned to you.

pub fn maybe_ref_rent_mut<__F, __R>(     _self: &mut Self,     f: __F ) -> Option<&mut __R> where     __F: for<'iref, 'head> FnOnce(&'iref mut &'head i32) -> Option<&'iref mut __R>,     __R: ?Sized,

Optionally return a mutable reference from the mutable suffix of the struct.

This is a subtle variation of rent_mut where it is legal to return a reference bounded by a rental lifetime, because that lifetime is reborrowed away before it is returned to you.

pub fn try_ref_rent_mut<__F, __R, __E>(     _self: &mut Self,     f: __F ) -> Result<&mut __R, __E> where     __F: for<'iref, 'head> FnOnce(&'iref mut &'head i32) -> Result<&'iref mut __R, __E>,     __R: ?Sized,

Try to return a mutable reference from the mutable suffix of the struct, or an error on failure.

This is a subtle variation of rent_mut where it is legal to return a reference bounded by a rental lifetime, because that lifetime is reborrowed away before it is returned to you.

Important traits for Box<R>

impl<R> Read for Box<R> where
    R: Read + ?Sized, impl<W> Write for Box<W> where
    W: Write + ?Sized, impl<I> Iterator for Box<I> where
    I: Iterator + ?Sized,  type Item = <I as Iterator>::Item;

pub fn into_head(_self: Self) -> Box<i32>

Drop the rental struct and return the original head value to you.

impl SimpleRefDeref

Important traits for Box<R>

impl<R> Read for Box<R> where
    R: Read + ?Sized, impl<W> Write for Box<W> where
    W: Write + ?Sized, impl<I> Iterator for Box<I> where
    I: Iterator + ?Sized,  type Item = <I as Iterator>::Item;

pub fn head(_self: &Self) -> &<Box<i32> as Deref>::Target

Return a shared reference to the head field of the struct.

pub fn rent_all<__F, __R>(_self: &Self, f: __F) -> __R where     __F: for<'head, 'iref> FnOnce(SimpleRefDeref_Borrow<'head, 'iref>) -> __R,     __R: ,

Execute a closure on shared borrows of the fields of the struct.

The closure may return any value not bounded by one of the special rentail lifetimes of the struct.

Important traits for &'a mut R

impl<'a, R> Read for &'a mut R where
    R: Read + ?Sized, impl<'a, W> Write for &'a mut W where
    W: Write + ?Sized, impl<'a, I> Iterator for &'a mut I where
    I: Iterator + ?Sized,  type Item = <I as Iterator>::Item;

pub fn ref_rent_all<__F, __R>(_self: &Self, f: __F) -> &__R where     __F: for<'head, 'iref> FnOnce(SimpleRefDeref_Borrow<'head, 'iref>) -> &'iref __R,     __R: ?Sized,

Return a shared reference from shared borrows of the fields of the struct.

This is a subtle variation of rent_all where it is legal to return a reference bounded by a rental lifetime, because that lifetime is reborrowed away before it is returned to you.

pub fn maybe_ref_rent_all<__F, __R>(_self: &Self, f: __F) -> Option<&__R> where     __F: for<'head, 'iref> FnOnce(SimpleRefDeref_Borrow<'head, 'iref>) -> Option<&'iref __R>,     __R: ?Sized,

Optionally return a shared reference from shared borrows of the fields of the struct.

This is a subtle variation of rent_all where it is legal to return a reference bounded by a rental lifetime, because that lifetime is reborrowed away before it is returned to you.

pub fn try_ref_rent_all<__F, __R, __E>(     _self: &Self,     f: __F ) -> Result<&__R, __E> where     __F: for<'head, 'iref> FnOnce(SimpleRefDeref_Borrow<'head, 'iref>) -> Result<&'iref __R, __E>,     __R: ?Sized,

Try to return a shared reference from shared borrows of the fields of the struct, or an error on failure.

This is a subtle variation of rent_all where it is legal to return a reference bounded by a rental lifetime, because that lifetime is reborrowed away before it is returned to you.

pub fn rent_all_mut<__F, __R>(_self: &mut Self, f: __F) -> __R where     __F: for<'head, 'iref> FnOnce(SimpleRefDeref_BorrowMut<'head, 'iref>) -> __R,     __R: ,

Execute a closure on shared borrows of the prefix fields and a mutable borrow of the suffix field of the struct.

The closure may return any value not bounded by one of the special rentail lifetimes of the struct.

Important traits for &'a mut R

impl<'a, R> Read for &'a mut R where
    R: Read + ?Sized, impl<'a, W> Write for &'a mut W where
    W: Write + ?Sized, impl<'a, I> Iterator for &'a mut I where
    I: Iterator + ?Sized,  type Item = <I as Iterator>::Item;

pub fn ref_rent_all_mut<__F, __R>(_self: &mut Self, f: __F) -> &mut __R where     __F: for<'head, 'iref> FnOnce(SimpleRefDeref_BorrowMut<'head, 'iref>) -> &'iref mut __R,     __R: ?Sized,

Return a mutable reference from shared borrows of the prefix fields and a mutable borrow of the suffix field of the struct.

This is a subtle variation of rent_all_mut where it is legal to return a reference bounded by a rental lifetime, because that lifetime is reborrowed away before it is returned to you.

pub fn maybe_ref_rent_all_mut<__F, __R>(     _self: &mut Self,     f: __F ) -> Option<&mut __R> where     __F: for<'head, 'iref> FnOnce(SimpleRefDeref_BorrowMut<'head, 'iref>) -> Option<&'iref mut __R>,     __R: ?Sized,

Optionally return a mutable reference from shared borrows of the prefix fields and a mutable borrow of the suffix field of the struct.

This is a subtle variation of rent_all_mut where it is legal to return a reference bounded by a rental lifetime, because that lifetime is reborrowed away before it is returned to you.

pub fn try_ref_rent_all_mut<__F, __R, __E>(     _self: &mut Self,     f: __F ) -> Result<&mut __R, __E> where     __F: for<'head, 'iref> FnOnce(SimpleRefDeref_BorrowMut<'head, 'iref>) -> Result<&'iref mut __R, __E>,     __R: ?Sized,

Try to return a mutable reference from shared borrows of the prefix fields and a mutable borrow of the suffix field of the struct, or an error on failure.

This is a subtle variation of rent_all_mut where it is legal to return a reference bounded by a rental lifetime, because that lifetime is reborrowed away before it is returned to you.

Methods from Deref<Target = <&'static i32 as Deref>::Target>

Trait Implementations

impl Deref for SimpleRefDeref

type Target = <&'static i32 as Deref>::Target

The resulting type after dereferencing.

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

Dereferences the value.

impl AsRef<Self::Target> for SimpleRefDeref

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

Performs the conversion.