pub struct OwningPtr<'a>(_, _);
Expand description
Type-erased Box-like pointer to some unknown type chosen when constructing this type.
Conceptually represents ownership of whatever data is being pointed to and so is
responsible for calling its Drop
impl. This pointer is not responsible for freeing
the memory pointed to by this pointer as it may be pointing to an element in a Vec
or
to a local in a function etc.
This type tries to act “borrow-like” like which means that:
- Pointer should be considered exclusive and mutable. It cannot be cloned as this would lead to aliased mutability and potentially use after free bugs.
- It must always points to a valid value of whatever the pointee type is.
- The lifetime
'a
accurately represents how long the pointer is valid for.
It may be helpful to think of this type as similar to &'a mut ManuallyDrop<dyn Any>
but
without the metadata and able to point to data that does not correspond to a Rust type.
Implementations§
§impl OwningPtr<'_>
impl OwningPtr<'_>
pub unsafe fn byte_offset(self, count: isize) -> OwningPtr<'_>
pub unsafe fn byte_offset(self, count: isize) -> OwningPtr<'_>
Calculates the offset from a pointer.
As the pointer is type-erased, there is no size information available. The provided
count
parameter is in raw bytes.
See also: ptr::offset
Safety
the offset cannot make the existing ptr null, or take it out of bounds for its allocation.
pub unsafe fn byte_add(self, count: usize) -> OwningPtr<'_>
pub unsafe fn byte_add(self, count: usize) -> OwningPtr<'_>
Calculates the offset from a pointer (convenience for .offset(count as isize)
).
As the pointer is type-erased, there is no size information available. The provided
count
parameter is in raw bytes.
See also: ptr::add
Safety
the offset cannot make the existing ptr null, or take it out of bounds for its allocation.
Auto Trait Implementations§
impl<'a> RefUnwindSafe for OwningPtr<'a>
impl<'a> !Send for OwningPtr<'a>
impl<'a> !Sync for OwningPtr<'a>
impl<'a> Unpin for OwningPtr<'a>
impl<'a> !UnwindSafe for OwningPtr<'a>
Blanket Implementations§
§impl<T, U> AsBindGroupShaderType<U> for Twhere
U: ShaderType,
&'a T: for<'a> Into<U>,
impl<T, U> AsBindGroupShaderType<U> for Twhere
U: ShaderType,
&'a T: for<'a> Into<U>,
§fn as_bind_group_shader_type(&self, _images: &RenderAssets<Image>) -> U
fn as_bind_group_shader_type(&self, _images: &RenderAssets<Image>) -> U
T
ShaderType
for self
. When used in AsBindGroup
derives, it is safe to assume that all images in self
exist. Read more§impl<T> Downcast for Twhere
T: Any,
impl<T> Downcast for Twhere
T: Any,
§fn into_any(self: Box<T, Global>) -> Box<dyn Any + 'static, Global>
fn into_any(self: Box<T, Global>) -> Box<dyn Any + 'static, Global>
Box<dyn Trait>
(where Trait: Downcast
) to Box<dyn Any>
. Box<dyn Any>
can
then be further downcast
into Box<ConcreteType>
where ConcreteType
implements Trait
. Read more§fn into_any_rc(self: Rc<T>) -> Rc<dyn Any + 'static>
fn into_any_rc(self: Rc<T>) -> Rc<dyn Any + 'static>
Rc<Trait>
(where Trait: Downcast
) to Rc<Any>
. Rc<Any>
can then be
further downcast
into Rc<ConcreteType>
where ConcreteType
implements Trait
. Read more§fn as_any(&self) -> &(dyn Any + 'static)
fn as_any(&self) -> &(dyn Any + 'static)
&Trait
(where Trait: Downcast
) to &Any
. This is needed since Rust cannot
generate &Any
’s vtable from &Trait
’s. Read more§fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
&mut Trait
(where Trait: Downcast
) to &Any
. This is needed since Rust cannot
generate &mut Any
’s vtable from &mut Trait
’s. Read more