Struct bevy_ptr::ConstNonNull

source ·
pub struct ConstNonNull<T: ?Sized>(/* private fields */);
Expand description

A newtype around NonNull that only allows conversion to read-only borrows or pointers.

This type can be thought of as the *const T to NonNull<T>’s *mut T.

Implementations§

source§

impl<T: ?Sized> ConstNonNull<T>

source

pub fn new(ptr: *const T) -> Option<Self>

Creates a new ConstNonNull if ptr is non-null.

§Examples
use bevy_ptr::ConstNonNull;

let x = 0u32;
let ptr = ConstNonNull::<u32>::new(&x as *const _).expect("ptr is null!");

if let Some(ptr) = ConstNonNull::<u32>::new(std::ptr::null()) {
    unreachable!();
}
source

pub const unsafe fn new_unchecked(ptr: *const T) -> Self

Creates a new ConstNonNull.

§Safety

ptr must be non-null.

§Examples
use bevy_ptr::ConstNonNull;

let x = 0u32;
let ptr = unsafe { ConstNonNull::new_unchecked(&x as *const _) };

Incorrect usage of this function:

use bevy_ptr::ConstNonNull;

// NEVER DO THAT!!! This is undefined behavior. ⚠️
let ptr = unsafe { ConstNonNull::<u32>::new_unchecked(std::ptr::null()) };
source

pub unsafe fn as_ref<'a>(&self) -> &'a T

Returns a shared reference to the value.

§Safety

When calling this method, you have to ensure that all of the following is true:

  • The pointer must be properly aligned.

  • It must be “dereferenceable” in the sense defined in the module documentation.

  • The pointer must point to an initialized instance of T.

  • You must enforce Rust’s aliasing rules, since the returned lifetime 'a is arbitrarily chosen and does not necessarily reflect the actual lifetime of the data. In particular, while this reference exists, the memory the pointer points to must not get mutated (except inside UnsafeCell).

This applies even if the result of this method is unused! (The part about being initialized is not yet fully decided, but until it is, the only safe approach is to ensure that they are indeed initialized.)

§Examples
use bevy_ptr::ConstNonNull;

let mut x = 0u32;
let ptr = ConstNonNull::new(&mut x as *mut _).expect("ptr is null!");

let ref_x = unsafe { ptr.as_ref() };
println!("{ref_x}");

Trait Implementations§

source§

impl<'a, T: ?Sized> From<&'a T> for ConstNonNull<T>

source§

fn from(value: &'a T) -> ConstNonNull<T>

Converts to this type from the input type.
source§

impl<'a, T: ?Sized> From<&'a mut T> for ConstNonNull<T>

source§

fn from(value: &'a mut T) -> ConstNonNull<T>

Converts to this type from the input type.
source§

impl<T: ?Sized> From<NonNull<T>> for ConstNonNull<T>

source§

fn from(value: NonNull<T>) -> ConstNonNull<T>

Converts to this type from the input type.

Auto Trait Implementations§

§

impl<T> Freeze for ConstNonNull<T>
where T: ?Sized,

§

impl<T> RefUnwindSafe for ConstNonNull<T>
where T: RefUnwindSafe + ?Sized,

§

impl<T> !Send for ConstNonNull<T>

§

impl<T> !Sync for ConstNonNull<T>

§

impl<T> Unpin for ConstNonNull<T>
where T: ?Sized,

§

impl<T> UnwindSafe for ConstNonNull<T>
where T: RefUnwindSafe + ?Sized,

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.