Skip to main content

ExternalSlice

Struct ExternalSlice 

Source
#[repr(C)]
pub struct ExternalSlice<T: 'static> { ptr: NonNull<T>, len: usize, capacity: usize, }
Expand description

A slice stored as a standalone struct, suitable for wrapping in ExternalPtr.

This is analogous to the data inside a Box<[T]>, but stores capacity for proper deallocation when created from a Vec.

§Usage

To use with ExternalPtr, implement TypedExternal for your specific ExternalSlice<YourType>:

impl_typed_external!(ExternalSlice<MyElement>);
let ptr = ExternalPtr::new(ExternalSlice::new(vec![1, 2, 3]));

Fields§

§ptr: NonNull<T>§len: usize§capacity: usize

Implementations§

Source§

impl<T: 'static> ExternalSlice<T>

Source

pub fn new(slice: Vec<T>) -> Self

Create an external slice from a Vec, preserving its allocation.

Source

pub fn from_boxed(boxed: Box<[T]>) -> Self

Create from a boxed slice (capacity == len).

Source

pub fn as_slice(&self) -> &[T]

Borrow the contents as a shared slice.

Source

pub fn as_mut_slice(&mut self) -> &mut [T]

Borrow the contents as a mutable slice.

Source

pub fn len(&self) -> usize

Number of elements in the slice.

Source

pub fn is_empty(&self) -> bool

Returns true if the slice is empty.

Source

pub fn capacity(&self) -> usize

Capacity of the underlying allocation.

Trait Implementations§

Source§

impl<T: 'static> Drop for ExternalSlice<T>

Source§

fn drop(&mut self)

Executes the destructor for this type. Read more
Source§

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)
Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned. Read more

Auto Trait Implementations§

§

impl<T> !Send for ExternalSlice<T>

§

impl<T> !Sync for ExternalSlice<T>

§

impl<T> Freeze for ExternalSlice<T>

§

impl<T> RefUnwindSafe for ExternalSlice<T>
where T: RefUnwindSafe,

§

impl<T> Unpin for ExternalSlice<T>

§

impl<T> UnsafeUnpin for ExternalSlice<T>

§

impl<T> UnwindSafe for ExternalSlice<T>
where T: RefUnwindSafe,

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> SizeHint for T
where T: ?Sized,

Source§

default fn lower_bound(&self) -> usize

🔬This is a nightly-only experimental API. (core_io_internals)
Returns a lower bound on the number of elements this container-like item contains. For example, an array [u8; 12] could return any value between 0 and 12 inclusively as a correct implementation. Read more
Source§

default fn upper_bound(&self) -> Option<usize>

🔬This is a nightly-only experimental API. (core_io_internals)
Returns an upper bound on the number of elements this container-like item contains if it can be determined, otherwise None. Read more
Source§

final fn size_hint(&self) -> (usize, Option<usize>)

🔬This is a nightly-only experimental API. (core_io_internals)
Returns an estimate for the number of elements this container like type contains. Read more
Source§

impl<T> SizedTypeProperties for T

Source§

#[doc(hidden)]
const SIZE: usize = _

🔬This is a nightly-only experimental API. (sized_type_properties)
Source§

#[doc(hidden)]
const ALIGN: usize = _

🔬This is a nightly-only experimental API. (sized_type_properties)
Source§

#[doc(hidden)]
const ALIGNMENT: Alignment = _

🔬This is a nightly-only experimental API. (ptr_alignment_type)
Source§

#[doc(hidden)]
const IS_ZST: bool = _

🔬This is a nightly-only experimental API. (sized_type_properties)
true if this type requires no storage. false if its size is greater than zero. Read more
Source§

#[doc(hidden)]
const LAYOUT: Layout = _

🔬This is a nightly-only experimental API. (sized_type_properties)
Source§

#[doc(hidden)]
const MAX_SLICE_LEN: usize = _

🔬This is a nightly-only experimental API. (sized_type_properties)
The largest safe length for a [Self]. Read more
Source§

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

Source§

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>,

Source§

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.

Layout§

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 24 bytes