Struct std::cell::Ref

1.0.0 · source ·
pub struct Ref<'b, T>where
    T: 'b + ?Sized,{ /* private fields */ }
Expand description

RefCell box 中将借用的引用括起来。 从 RefCell<T> 不变借来的值的包装器类型。

有关更多信息,请参见 模块级文档

Implementations§

source§

impl<'b, T> Ref<'b, T>where T: ?Sized,

1.15.0 · source

pub fn clone(orig: &Ref<'b, T>) -> Ref<'b, T>

复制一个 Ref

RefCell 已经被不可改变地借用了,因此这不会失败。

这是一个关联函数,需要用作 Ref::clone(...)Clone 的实现或方法将干扰 r.borrow().clone() 的广泛使用,以克隆 RefCell 的内容。

1.8.0 · source

pub fn map<U, F>(orig: Ref<'b, T>, f: F) -> Ref<'b, U>where F: FnOnce(&T) -> &U, U: ?Sized,

为借用数据的组件制作新的 Ref

RefCell 已经被不可改变地借用了,因此这不会失败。

这是一个关联函数,需要用作 Ref::map(...)。 方法会干扰通过 Deref 使用的 RefCell 内容中的同名方法。

Examples
use std::cell::{RefCell, Ref};

let c = RefCell::new((5, 'b'));
let b1: Ref<'_, (u32, char)> = c.borrow();
let b2: Ref<'_, u32> = Ref::map(b1, |t| &t.0);
assert_eq!(*b2, 5)
Run
1.63.0 · source

pub fn filter_map<U, F>( orig: Ref<'b, T>, f: F ) -> Result<Ref<'b, U>, Ref<'b, T>>where F: FnOnce(&T) -> Option<&U>, U: ?Sized,

为借用数据的可选组件制作新的 Ref。 如果闭包返回 None,则原始守卫将作为 Err(..) 返回。

RefCell 已经被不可改变地借用了,因此这不会失败。

这是一个关联函数,需要用作 Ref::filter_map(...)。 方法会干扰通过 Deref 使用的 RefCell 内容中的同名方法。

Examples
use std::cell::{RefCell, Ref};

let c = RefCell::new(vec![1, 2, 3]);
let b1: Ref<'_, Vec<u32>> = c.borrow();
let b2: Result<Ref<'_, u32>, _> = Ref::filter_map(b1, |v| v.get(1));
assert_eq!(*b2.unwrap(), 2);
Run
1.35.0 · source

pub fn map_split<U, V, F>(orig: Ref<'b, T>, f: F) -> (Ref<'b, U>, Ref<'b, V>)where F: FnOnce(&T) -> (&U, &V), U: ?Sized, V: ?Sized,

Ref 拆分为多个 Ref,以用于借用数据的不同组成部分。

RefCell 已经被不可改变地借用了,因此这不会失败。

这是一个关联函数,需要用作 Ref::map_split(...)。 方法会干扰通过 Deref 使用的 RefCell 内容中的同名方法。

Examples
use std::cell::{Ref, RefCell};

let cell = RefCell::new([1, 2, 3, 4]);
let borrow = cell.borrow();
let (begin, end) = Ref::map_split(borrow, |slice| slice.split_at(2));
assert_eq!(*begin, [1, 2]);
assert_eq!(*end, [3, 4]);
Run
source

pub fn leak(orig: Ref<'b, T>) -> &'b T

🔬This is a nightly-only experimental API. (cell_leak #69099)

转换为对底层数据的引用。

底层的 RefCell 永远不会再被可变借用,并且总是看起来已经是不可更改的借用。

泄漏超过一定数量的引用不是一个好主意。 如果总共只发生了少量的泄漏,则可以再次借用 RefCell

这是一个关联函数,需要用作 Ref::leak(...)。 方法会干扰通过 Deref 使用的 RefCell 内容中的同名方法。

Examples
#![feature(cell_leak)]
use std::cell::{RefCell, Ref};
let cell = RefCell::new(0);

let value = Ref::leak(cell.borrow());
assert_eq!(*value, 0);

assert!(cell.try_borrow().is_ok());
assert!(cell.try_borrow_mut().is_err());
Run

Trait Implementations§

source§

impl<T> Debug for Ref<'_, T>where T: Debug + ?Sized,

source§

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

使用给定的格式化程序格式化该值。 Read more
source§

impl<T> Deref for Ref<'_, T>where T: ?Sized,

§

type Target = T

解引用后的结果类型。
source§

fn deref(&self) -> &T

解引用值。
1.20.0 · source§

impl<T> Display for Ref<'_, T>where T: Display + ?Sized,

source§

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

使用给定的格式化程序格式化该值。 Read more
source§

impl<'b, T, U> CoerceUnsized<Ref<'b, U>> for Ref<'b, T>where T: Unsize<U> + ?Sized, U: ?Sized,

Auto Trait Implementations§

§

impl<'b, T> !RefUnwindSafe for Ref<'b, T>

§

impl<'b, T> !Send for Ref<'b, T>

§

impl<'b, T> !Sync for Ref<'b, T>

§

impl<'b, T: ?Sized> Unpin for Ref<'b, T>

§

impl<'b, T> !UnwindSafe for Ref<'b, T>

Blanket Implementations§

source§

impl<T> Any for Twhere T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

获取 selfTypeIdRead more
source§

impl<T> Borrow<T> for Twhere T: ?Sized,

source§

fn borrow(&self) -> &T

从拥有的值中一成不变地借用。 Read more
source§

impl<T> BorrowMut<T> for Twhere T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

从拥有的值中借用。 Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

返回未更改的参数。

source§

impl<T, U> Into<U> for Twhere U: From<T>,

source§

fn into(self) -> U

调用 U::from(self)

也就是说,这种转换是 From<T> for U 实现选择执行的任何操作。

source§

impl<T> ToString for Twhere T: Display + ?Sized,

source§

default fn to_string(&self) -> String

将给定值转换为 StringRead more
source§

impl<T, U> TryFrom<U> for Twhere U: Into<T>,

§

type Error = Infallible

发生转换错误时返回的类型。
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

执行转换。
source§

impl<T, U> TryInto<U> for Twhere U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

发生转换错误时返回的类型。
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

执行转换。