Struct statiki::Array

pub struct Array<T, const C: usize> { /* fields omitted */ }

Static array with Vec-like interface

Implementations

impl<T, const C: usize> Array<T, C>

pub const fn new() -> Self

Creates new empty instance

pub const fn len(&self) -> usize

Returns length of vector.

pub const fn as_ptr(&self) -> *const T

Returns pointer to first element in underlying buffer.

pub fn as_mut_ptr(&mut self) -> *mut T

Returns pointer to first element in underlying buffer.

pub unsafe fn get_unchecked(&self, index: usize) -> &T

Retrieves reference to element without checking boundaries.

pub unsafe fn get_unchecked_mut(&mut self, index: usize) -> &mut T

Retrieves mutable reference to element without checking boundaries.

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

Returns immutable slice with current elements

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

Returns mutable slice with current elements

pub fn truncate(&mut self, len: usize)

Shortens vector, keeping the first len elements.

Does nothing if len is greater or equal to vector length.

pub const fn is_empty(&self) -> bool

Returns whether vector is empty.

pub const fn capacity(&self) -> usize

Returns vector capacity.

pub unsafe fn set_len(&mut self, new_len: usize)

Sets new length of vector.

Notes:

Panics in debug mode only when new_len is greater than CAPACITY.

pub fn clear(&mut self)

Removes all elements from vector

pub unsafe fn push_unchecked(&mut self, value: T)

Appends element at the end, without checking capacity

pub fn push(&mut self, value: T) -> Option<T>

Appends element at the end.

Returns Some(T) on capacity overflow

pub unsafe fn pop_unchecked(&mut self) -> T

Unconditionally retrieves element from vector.

pub fn pop(&mut self) -> Option<T>

Pops element out of vector.

pub unsafe fn swap_remove_unchecked(&mut self, index: usize) -> T

Removes element at index by swapping it with last element, and popping out.

pub fn swap_remove(&mut self, index: usize) -> T

Removes element at index by swapping it with last element, and popping out.

Note:

Panics when index is out of bounds

pub unsafe fn resize_unchecked(&mut self, new_len: usize, value: T) where
    T: Clone, 

Resizes vector with provided value

If new_len is greater than len, the Array is extended by the difference, with each additional slot filled with value. If new_len is less than len, the Array is simply truncated.

pub fn resize(&mut self, new_len: usize, value: T) where
    T: Clone, 

Resizes vector with provided value

If new_len is greater than len, the Array is extended by the difference, with each additional slot filled with value. If new_len is less than len, the Array is simply truncated.

Note:

Panics if new_len is greater than CAPACITY

pub unsafe fn resize_default_unchecked(&mut self, new_len: usize) where
    T: Default, 

Resizes vector with default values.

If new_len is greater than len, the Array is extended by the difference, with each additional slot filled with value. If new_len is less than len, the Array is simply truncated.

pub fn resize_default(&mut self, new_len: usize) where
    T: Default, 

Resizes vector with default values.

If new_len is greater than len, the Array is extended by the difference, with each additional slot filled with value. If new_len is less than len, the Array is simply truncated.

Note:

Panics if new_len is greater than CAPACITY

Trait Implementations

impl<T, const C: usize> AsMut<[T]> for Array<T, C>

fn as_mut(&mut self) -> &mut [T]

Performs the conversion.

impl<T, const C: usize> AsMut<Array<T, C>> for Array<T, C>

fn as_mut(&mut self) -> &mut Self

Performs the conversion.

impl<T, const C: usize> AsRef<[T]> for Array<T, C>

fn as_ref(&self) -> &[T]

Performs the conversion.

impl<T, const C: usize> AsRef<Array<T, C>> for Array<T, C>

fn as_ref(&self) -> &Self

Performs the conversion.

impl<T: Debug, const C: usize> Debug for Array<T, C>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<T, const C: usize> Deref for Array<T, C>

type Target = [T]

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<T, const C: usize> DerefMut for Array<T, C>

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl<T, const C: usize> Drop for Array<T, C>

fn drop(&mut self)

Executes the destructor for this type.

impl<const C: usize> Write for Array<u8, C>

fn write(&mut self, buf: &[u8]) -> Result<usize>

Write a buffer into this writer, returning how many bytes were written.

fn flush(&mut self) -> Result<()>

Flush this output stream, ensuring that all intermediately buffered contents reach their destination.

fn write_vectored(&mut self, bufs: &[IoSlice<'_>]) -> Result<usize, Error>

Like write, except that it writes from a slice of buffers.

fn is_write_vectored(&self) -> bool

🔬 This is a nightly-only experimental API. (can_vector)

Determines if this Writer has an efficient write_vectored implementation.

fn write_all(&mut self, buf: &[u8]) -> Result<(), Error>

Attempts to write an entire buffer into this writer.

fn write_all_vectored(&mut self, bufs: &mut [IoSlice<'_>]) -> Result<(), Error>

🔬 This is a nightly-only experimental API. (write_all_vectored)

Attempts to write multiple buffers into this writer.

fn write_fmt(&mut self, fmt: Arguments<'_>) -> Result<(), Error>

Writes a formatted string into this writer, returning any error encountered.

fn by_ref(&mut self) -> &mut Self

Creates a “by reference” adaptor for this instance of Write.