flexrc 0.1.0

A flexible/modular alternative to Rust Rc/Arc with unique hybrid capabilities
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

mod hybrid;
#[cfg(feature = "track_threads")]
mod hybrid_threads;
mod regular;

use crate::FlexRcInner;

pub use hybrid::*;
pub use regular::*;

pub trait Algorithm<META, META2> {
    /// Create and return new metadata    
    fn create() -> Self;

    /// Returns true if this instance is the last one before final release of resources
    fn is_unique(&self) -> bool;

    /// Increment reference counters
    fn clone(&self);

    /// Decrement reference counters and return true if storage should be deallocated
    fn drop(&self) -> bool;

    /// Attempts to converts one inner type into another while consuming the other
    fn try_into_other<T: ?Sized>(
        &self,
        inner: *mut FlexRcInner<META, META2, T>,
    ) -> Result<*mut FlexRcInner<META2, META, T>, *mut FlexRcInner<META, META2, T>>;

    /// Attempts to converts one inner type into another but NOT consuming the other
    fn try_to_other<T: ?Sized>(
        &self,
        inner: *mut FlexRcInner<META, META2, T>,
    ) -> Result<*mut FlexRcInner<META2, META, T>, *mut FlexRcInner<META, META2, T>>;
}

#[cfg(feature = "std")]
#[inline]
fn abort() {
    std::process::abort()
}

#[cfg(not(feature = "std"))]
#[inline]
fn abort() {
    // Abort not available on no_std
    panic!("Reference count overflow");
}