Struct StaticBuf 

pub struct StaticBuf<T: Copy, ArrayBuf: AsRef<[T]> + AsMut<[T]> + Default + Copy> { /* private fields */ }

Static byte buffer. StaticBuf<[u8; 16]> can store a [u8] array from 0-16 bytes for example. Unlike other static buffers, this does NOT reallocate if you out grow the internal buffer. If you try to request more bytes than its able to store, it will panic.

Implementations

impl<T: Copy, ArrayBuf: AsRef<[T]> + AsMut<[T]> + Default + Copy> StaticBuf<T, ArrayBuf>

pub fn new() -> Self

pub fn max_size() -> usize

Returns the maximum size the StaticBuf can hold.

Examples

use btle::bytes::StaticBuf;
assert_eq!(StaticBuf::<u8, [u8; 10]>::max_size(), 10);
assert_eq!(StaticBuf::<u8, [u8; 23]>::max_size(), 23);

pub fn space_left(&self) -> usize

Returns the space left in Ts (not bytes) in the StaticBuf. Simply (capacity - length).

pub fn resize(&mut self, new_size: usize)

Resizes the StaticBuf by settings self.len to new_size if new_size <= Self::max_size(). This is only a single variable change and WILL NOT zero or change any of the buffers bytes.

Panics

Panics if the new size is greater than max_size (new_size > Self::max_size()).

Examples

use btle::bytes::{StaticBuf, Storage};
let mut buf = StaticBuf::<u8, [u8; 10]>::with_size(10);
assert_eq!(buf.len(), 10);
assert_eq!(buf[9], 0);
buf[9] = 0xFF;
buf.resize(1);
assert_eq!(buf.len(), 1);
buf.resize(10);
assert_eq!(buf[9], 0xFF);

pub fn append_slice(&mut self, slice: &[T])

Appends the slice onto the end of the StaticBuf.

Panics

Panics if appending the slice would overflow the StaticBuf (not enough space).

Trait Implementations

impl<T: Copy, ArrayBuf: AsRef<[T]> + AsMut<[T]> + Default + Copy> AsMut<[T]> for StaticBuf<T, ArrayBuf>

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

Converts this type into a mutable reference of the (usually inferred) input type.

impl<T: Copy, ArrayBuf: AsRef<[T]> + AsMut<[T]> + Default + Copy> AsRef<[T]> for StaticBuf<T, ArrayBuf>

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

Converts this type into a shared reference of the (usually inferred) input type.

impl<T: Clone + Copy, ArrayBuf: Clone + AsRef<[T]> + AsMut<[T]> + Default + Copy> Clone for StaticBuf<T, ArrayBuf>

fn clone(&self) -> StaticBuf<T, ArrayBuf>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug + Copy, ArrayBuf: Debug + AsRef<[T]> + AsMut<[T]> + Default + Copy> Debug for StaticBuf<T, ArrayBuf>

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

Formats the value using the given formatter.

impl<T: Default + Copy, ArrayBuf: Default + AsRef<[T]> + AsMut<[T]> + Default + Copy> Default for StaticBuf<T, ArrayBuf>

fn default() -> StaticBuf<T, ArrayBuf>

Returns the “default value” for a type.

impl<T: Hash + Copy, ArrayBuf: Hash + AsRef<[T]> + AsMut<[T]> + Default + Copy> Hash for StaticBuf<T, ArrayBuf>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<T: Copy, ArrayBuf: AsRef<[T]> + AsMut<[T]> + Default + Copy> Index<RangeFull> for StaticBuf<T, ArrayBuf>

type Output = [T]

The returned type after indexing.

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

Performs the indexing (container[index]) operation.

impl<T: Copy + Default, ArrayBuf: AsRef<[T]> + AsMut<[T]> + Default + Copy> Index<usize> for StaticBuf<T, ArrayBuf>

type Output = T

The returned type after indexing.

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

Performs the indexing (container[index]) operation.

impl<T: Copy, ArrayBuf: AsRef<[T]> + AsMut<[T]> + Default + Copy> IndexMut<RangeFull> for StaticBuf<T, ArrayBuf>

fn index_mut(&mut self, _index: RangeFull) -> &mut Self::Output

Performs the mutable indexing (container[index]) operation.

impl<T: Copy + Default, ArrayBuf: AsRef<[T]> + AsMut<[T]> + Default + Copy> IndexMut<usize> for StaticBuf<T, ArrayBuf>

fn index_mut(&mut self, index: usize) -> &mut Self::Output

Performs the mutable indexing (container[index]) operation.

impl<T: Ord + Copy, ArrayBuf: Ord + AsRef<[T]> + AsMut<[T]> + Default + Copy> Ord for StaticBuf<T, ArrayBuf>

fn cmp(&self, other: &StaticBuf<T, ArrayBuf>) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl<T: PartialEq + Copy, ArrayBuf: PartialEq + AsRef<[T]> + AsMut<[T]> + Default + Copy> PartialEq for StaticBuf<T, ArrayBuf>

fn eq(&self, other: &StaticBuf<T, ArrayBuf>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<T: PartialOrd + Copy, ArrayBuf: PartialOrd + AsRef<[T]> + AsMut<[T]> + Default + Copy> PartialOrd for StaticBuf<T, ArrayBuf>

fn partial_cmp(&self, other: &StaticBuf<T, ArrayBuf>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl<T: Copy + Unpin + Default, ArrayBuf: AsRef<[T]> + AsMut<[T]> + Default + Copy + Unpin> Storage<T> for StaticBuf<T, ArrayBuf>

fn with_size(size: usize) -> Self

where Self: Sized,

fn max_len() -> usize

fn len(&self) -> usize

fn from_slice(buf: &[T]) -> Self

where Self: Sized,

fn space_left(&self) -> usize

impl<T: Copy + Copy, ArrayBuf: Copy + AsRef<[T]> + AsMut<[T]> + Default + Copy> Copy for StaticBuf<T, ArrayBuf>

impl<T: Eq + Copy, ArrayBuf: Eq + AsRef<[T]> + AsMut<[T]> + Default + Copy> Eq for StaticBuf<T, ArrayBuf>

impl<T: Copy, ArrayBuf: AsRef<[T]> + AsMut<[T]> + Default + Copy> StructuralPartialEq for StaticBuf<T, ArrayBuf>