atomic-tagged-ptr 0.2.0

A platform-adaptive atomic tagged pointer implementation supporting 32-bit, 48-bit, and 52/57-bit high virtual address layouts with ABA protection.
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

use core::ptr::NonNull;

/// A helper trait to unify various raw pointer types (`NonNull<T>`, `Option<NonNull<T>>`, `*const T`, `*mut T`, etc.)
/// and convert them into `Option<NonNull<T>>`.
///
/// This trait optimizes the developer experience when passing pointer arguments to `AtomicTaggedPtr`.
pub trait IntoOptionNonNull<T> {
    /// Converts `self` into `Option<NonNull<T>>`.
    fn into_option_non_null(self) -> Option<NonNull<T>>;
}

impl<T> IntoOptionNonNull<T> for Option<NonNull<T>> {
    #[inline]
    fn into_option_non_null(self) -> Option<NonNull<T>> {
        self
    }
}

impl<T> IntoOptionNonNull<T> for NonNull<T> {
    #[inline]
    fn into_option_non_null(self) -> Option<NonNull<T>> {
        Some(self)
    }
}

impl<T> IntoOptionNonNull<T> for *const T {
    #[inline]
    fn into_option_non_null(self) -> Option<NonNull<T>> {
        NonNull::new(self as *mut T)
    }
}

impl<T> IntoOptionNonNull<T> for *mut T {
    #[inline]
    fn into_option_non_null(self) -> Option<NonNull<T>> {
        NonNull::new(self)
    }
}