ros666/utils/safety.rs
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46
//! 安全性相关
use core::cell::{RefCell, RefMut};
/// 一个线程安全的 `RefCell` 包装器。
///
/// "I Promise I'm Safe RefCell :)"
pub struct SyncRefCell<T> {
pub ref_cell: RefCell<T>,
}
unsafe impl<T> Sync for SyncRefCell<T> {}
impl<T> SyncRefCell<T> {
/// 创建一个新的 `SyncRefCell` 实例。
///
/// ## 参数
/// * `t` - 要存储在 `SyncRefCell` 中的值。
/// ## 返回值
/// 返回一个包含给定值的 `SyncRefCell` 实例。
pub fn new(t: T) -> Self {
Self {
ref_cell: RefCell::new(t),
}
}
/// 获取对内部值的可变引用。
///
/// ## 返回
/// 返回一个可变引用,允许修改内部值。
/// ## 安全性
/// 如果已经有不可变引用存在,则此方法会导致运行时 `Panic`。
pub fn inner_borrow_mut(&self) -> RefMut<'_, T> {
self.ref_cell.borrow_mut()
}
/// 获取对内部值的不可变引用。
///
/// ## 返回
/// 返回一个不可变引用,允许读取内部值。
/// ## 安全性
/// 如果已经有可变引用存在,则此方法会导致运行时 `Panic`。
pub fn inner_borrow(&self) -> core::cell::Ref<'_, T> {
self.ref_cell.borrow()
}
}