lv-std 0.0.4

some utils for c and unsafe rust, this is for personal use for now so you can use it but don't expect any regular updates or maintaining
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

use std::marker::PhantomData;
use std::ops::{Deref, DerefMut};
use crate::unsafe_std::lifetimes::{extend_lifetime, extend_lifetime_mut};
use crate::unsafe_std::ptrs::unsafe_shared::{UnsafeShared, UnsafeSharedRef};

/// # Safety
/// `Shared<T>` is a manually managed, stack-based shared smart pointer.
/// It allows you to take multiple shared references, or a single unique one,
/// but it **does not** perform any runtime checks — soundness relies on you
/// upholding aliasing rules.
#[derive(Copy, Clone)]
pub struct Shared<T> {
    value: UnsafeShared<T>,
}

impl<T> Shared<T> {
    /// Creates a new shared container for a value.
    #[inline]
    pub fn new(value: T) -> Self {
        Self {
            value: unsafe { UnsafeShared::new(value) },
        }
    }

    /// Takes a temporary shared reference to the value.
    ///
    /// # Safety
    /// This is only safe if the returned reference does not outlive `self`.
    /// The borrow checker enforces this, so in safe Rust usage, this method is sound.
    #[inline]
    pub fn take_ref(&mut self) -> SharedRef<'_, T> {
        SharedRef {
            ptr: unsafe { self.value.take_ref() },
            _marker: PhantomData,
        }
    }

    /// Internal helper if you ever need to extract the raw shared handle.
    #[inline]
    pub fn raw(&self) -> &UnsafeShared<T> {
        &self.value
    }
}

/// A reference handle returned by [`Shared::take_ref`].
/// Behaves like `&mut T` / `&T` depending on usage.
///
/// The lifetime `'b` is tied to the borrow of `&mut self` from `Shared`,
/// preventing `'static` or longer-lived references from being created.

#[derive(Copy, Clone)]
pub struct SharedRef<'b, T> {
    ptr: UnsafeSharedRef<T>,
    _marker: PhantomData<&'b T>,
}

impl<'b, T> Deref for SharedRef<'b, T> {
    type Target = T;

    #[inline]
    fn deref(&self) -> &'b T {
        unsafe { extend_lifetime(self.ptr.deref()) }
    }
}

impl<'b, T> DerefMut for SharedRef<'b, T> {
    #[inline]
    fn deref_mut(&mut self) -> &'b mut T {
        unsafe { extend_lifetime_mut(self.ptr.deref_mut()) }
    }
}