Trait Bos

pub trait Bos<T: ?Sized> {
    type Ref<'this>: Ref<T>
       where Self: 'this;

    // Required method
    fn borrow_or_share(this: &Self) -> Self::Ref<'_>;
}

A trait for either borrowing or sharing data.

See the crate-level documentation for more details.

Required Associated Types

type Ref<'this>: Ref<T> where Self: 'this

The resulting reference type. May only be &T.

Required Methods

fn borrow_or_share(this: &Self) -> Self::Ref<'_>

Borrows from *this or from behind a reference it holds, returning a reference of type Self::Ref.

In the latter case, the returned reference is said to be shared with *this.

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementations on Foreign Types

impl Bos<str> for String

type Ref<'this> = &'this str where Self: 'this

fn borrow_or_share(this: &Self) -> Self::Ref<'_>

impl Bos<CStr> for CString

type Ref<'this> = &'this CStr where Self: 'this

fn borrow_or_share(this: &Self) -> Self::Ref<'_>

impl Bos<OsStr> for OsString

Available on crate feature std only.

type Ref<'this> = &'this OsStr where Self: 'this

fn borrow_or_share(this: &Self) -> Self::Ref<'_>

impl Bos<Path> for PathBuf

Available on crate feature std only.

type Ref<'this> = &'this Path where Self: 'this

fn borrow_or_share(this: &Self) -> Self::Ref<'_>

impl<'a, T: ?Sized> Bos<T> for &'a T

type Ref<'this> = &'a T where Self: 'this

fn borrow_or_share(this: &Self) -> Self::Ref<'_>

impl<B: ?Sized + ToOwned> Bos<B> for Cow<'_, B>

type Ref<'this> = &'this B where Self: 'this

fn borrow_or_share(this: &Self) -> Self::Ref<'_>

impl<T> Bos<[T]> for Vec<T>

type Ref<'this> = &'this [T] where Self: 'this

fn borrow_or_share(this: &Self) -> Self::Ref<'_>

impl<T, const N: usize> Bos<[T]> for [T; N]

type Ref<'this> = &'this [T] where Self: 'this

fn borrow_or_share(this: &Self) -> Self::Ref<'_>

impl<T: ?Sized> Bos<T> for &mut T

type Ref<'this> = &'this T where Self: 'this

fn borrow_or_share(this: &Self) -> Self::Ref<'_>

impl<T: ?Sized> Bos<T> for Box<T>

type Ref<'this> = &'this T where Self: 'this

fn borrow_or_share(this: &Self) -> Self::Ref<'_>

impl<T: ?Sized> Bos<T> for Rc<T>

type Ref<'this> = &'this T where Self: 'this

fn borrow_or_share(this: &Self) -> Self::Ref<'_>

impl<T: ?Sized> Bos<T> for Arc<T>

type Ref<'this> = &'this T where Self: 'this

fn borrow_or_share(this: &Self) -> Self::Ref<'_>

Implementors