autowrap 1.0.0

Ergonomic smart pointer and interior mutability extensions
Documentation 
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
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71

#![cfg_attr(not(feature = "std"), no_std)]

#[cfg(feature = "std")]
extern crate std;


#[cfg(feature = "std")]
use std::{rc::Rc, cell::RefCell};

#[cfg(all(feature = "std", feature = "sync"))]
use std::sync::{Arc, Mutex};

use core::cell::Cell;

/// 扩展 trait：为任意 Sized 类型提供智能封装能力
///
/// 设计原则：
/// - 所有方法 inline
/// - 不产生额外抽象层
/// - 明确 trait bound
/// - feature 控制线程相关类型
pub trait WrapExt: Sized {

    /// 封装为 `Cell<T>`
    ///
    /// 要求 T: Copy
    #[inline(always)]
    fn cell(self) -> Cell<Self>
    where
        Self: Copy,
    {
        Cell::new(self)
    }

    /// 封装为 `RefCell<T>`
    #[cfg(feature = "std")]
    #[inline(always)]
    fn refcell(self) -> RefCell<Self> {
        RefCell::new(self)
    }

    /// 封装为 `Rc<T>`
    #[cfg(feature = "std")]
    #[inline(always)]
    fn rc(self) -> Rc<Self> {
        Rc::new(self)
    }

    /// 封装为 `Rc<RefCell<T>>`
    #[cfg(feature = "std")]
    #[inline(always)]
    fn rc_refcell(self) -> Rc<RefCell<Self>> {
        Rc::new(RefCell::new(self))
    }

    /// 封装为 `Arc<T>`
    #[cfg(all(feature = "std", feature = "sync"))]
    #[inline(always)]
    fn arc(self) -> Arc<Self> {
        Arc::new(self)
    }

    /// 封装为 `Arc<Mutex<T>>`
    #[cfg(all(feature = "std", feature = "sync"))]
    #[inline(always)]
    fn arc_mutex(self) -> Arc<Mutex<Self>> {
        Arc::new(Mutex::new(self))
    }
}

impl<T> WrapExt for T {}