Struct blend2d::array::Array

#[repr(transparent)]
pub struct Array<T: ArrayType> { /* fields omitted */ }

A contiguous growable array for use with the blend2d api. This is an array managed by blend2d, unless required one should use Vec instead. Its api tries to mimic Vec as close as possible.

Methods

impl<T: ArrayType> Array<T>

pub fn new() -> Self

Creates a new empty array.

pub fn with_capacity(cap: usize) -> Self

Creates a new empty array with space for cap elements.

pub fn clear(&mut self)

Clears the array and its contents.

pub fn shrink_to_fit(&mut self)

Shrinks the arrays allocated capacity down to its currently used size.

pub fn reserve(&mut self, n: usize)

Reserves capacity for at least n items.

Panics

Panics if blend2d returns an OutOfMemory error

pub fn try_reserve(&mut self, n: usize) -> Result<(), OutOfMemory>

Reserves capacity for at least n items.

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

Truncates the array down to n elements.

pub fn resize(&mut self, n: usize, fill: T) where
    T: Clone, 

Resizes the array so that its len is equal to n, filling any new items with fill.

pub fn remove(&mut self, index: usize) -> Result<()>

Removes the element at the given index.

pub fn remove_range<R: RangeBounds<usize>>(&mut self, range: R) -> Result<()>

Removes the elements whose indices reside inside of the range

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

Returns the array as a slice.

pub fn len(&self) -> usize

Returns the length of the array.

pub fn is_empty(&self) -> bool

Returns true if this array has no elements.

pub fn capacity(&self) -> usize

Returns the current capacity of the array.

impl<T> Array<T> where
    T: ArrayType + Clone, 

pub fn extend_from_slice<S: AsRef<[T]>>(&mut self, data: S)

Appends all items in the slice to the array.

pub fn insert_from_slice<S: AsRef<[T]>>(&mut self, index: usize, data: S)

Inserts all items in the slice into the array at the given index.

pub fn replace_from_slice<R, S>(&mut self, range: R, data: S) where
    R: RangeBounds<usize>,
    S: AsRef<[T]>, 

Replaces the elements specified by the range of indices with the given slice.

impl<T> Array<T> where
    T: ArrayType, 

pub fn push(&mut self, item: T)

pub fn insert(&mut self, index: usize, item: T)

pub fn replace(&mut self, index: usize, item: T)

impl Array<ImageCodec>

pub fn find_codec_by_name(&self, name: &str) -> Option<&ImageCodec>

Searches for an image codec in the array by the given name.

pub fn find_codec_by_data<R: AsRef<[u8]>>(&self, data: R) -> Option<&ImageCodec>

Searches for an image codec in the array by the given data.

Trait Implementations

impl<T> Geometry for Array<T> where
    [T]: Geometry,
    T: ArrayType, 

const GEO_TYPE: u32

impl<T: ArrayType + Clone> From<Vec<T>> for Array<T>

fn from(v: Vec<T>) -> Self

Performs the conversion.

impl<'a, T> From<&'a [T]> for Array<T> where
    T: ArrayType + Clone, 

fn from(v: &[T]) -> Self

Performs the conversion.

impl<T: ArrayType> PartialEq<Array<T>> for Array<T>

fn eq(&self, other: &Self) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use] fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<T: ArrayType> Clone for Array<T>

fn clone(&self) -> Self

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: ArrayType> AsMut<[T]> for Array<T>

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

Performs the conversion.

impl<T: ArrayType> AsRef<[T]> for Array<T>

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

Performs the conversion.

impl<T: ArrayType> Default for Array<T>

fn default() -> Self

Returns the "default value" for a type.

impl<'a, T: ArrayType> IntoIterator for &'a Array<T>

type Item = &'a T

The type of the elements being iterated over.

type IntoIter = Iter<'a, T>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<T: ArrayType> Extend<T> for Array<T>

fn extend<I>(&mut self, iter: I) where
    I: IntoIterator<Item = T>, 

Extends a collection with the contents of an iterator.

impl<T: ArrayType> Drop for Array<T>

fn drop(&mut self)

Executes the destructor for this type.

impl<T: ArrayType> DerefMut for Array<T>

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

Mutably dereferences the value.

impl<T: ArrayType> Deref for Array<T>

type Target = [T]

The resulting type after dereferencing.

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

Dereferences the value.

impl<T> Debug for Array<T> where
    T: ArrayType + Debug, 

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

Formats the value using the given formatter.

impl<T, I> Index<I> for Array<T> where
    T: ArrayType,
    I: SliceIndex<[T]>, 

type Output = I::Output

The returned type after indexing.

fn index(&self, index: I) -> &Self::Output

Performs the indexing (container[index]) operation.

impl<T: ArrayType> FromIterator<T> for Array<T>

Important traits for Array<u8>

impl Write for Array<u8>

fn from_iter<I>(iter: I) -> Array<T> where
    I: IntoIterator<Item = T>, 

Creates a value from an iterator.

impl<T: ArrayType> Borrow<[T]> for Array<T>

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

Immutably borrows from an owned value.

impl Write for Array<u8>

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 write_all(&mut self, buf: &[u8]) -> Result<(), Error>

Attempts to write an entire buffer 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.