Struct abin::Bin

#[repr(C)]pub struct Bin { /* fields omitted */ }

A binary that does not implement Send + Sync. See AnyBin for documentation; see SBin if you need Send + Sync. See BinFactory on how to create binaries.

use abin::{NewBin, BinFactory, Bin, AnyBin};
let bin : Bin = NewBin::from_static("Hello, I'm a binary!".as_bytes());
assert_eq!("Hello, I'm a binary!".as_bytes(), bin.as_slice());

Trait Implementations

impl AnyBin for Bin

fn as_slice(&self) -> &[u8]

Returns a view into this binary.

fn into_vec(self) -> Vec<u8>

Converts this binary into a Vec<u8> - the implementation tries to avoid copying memory whenever possible (best effort).

fn len(&self) -> usize

The length (number of bytes).

fn is_empty(&self) -> bool

true if this binary is empty.

fn slice<TRange>(&self, range: TRange) -> Option<Self> where
    TRange: RangeBounds<usize>, 

Returns a slice if the given range is within bounds.

fn try_to_re_integrate(&self, slice: &[u8]) -> Option<Self>

Tries to re-integrate the given slice into self. To some extent (not 100%), this is the reverse of as_slice.

impl AsRef<[u8]> for Bin

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

Performs the conversion.

impl BooToOwned<[u8], Bin> for NewBin

fn convert_to_owned(borrowed: &[u8]) -> Bin

Converts the borrowed value of Boo to owned.

impl Borrow<[u8]> for Bin

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

Immutably borrows from an owned value.

impl Clone for Bin

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Bin

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

Formats the value using the given formatter.

impl Deref for Bin

type Target = [u8]

The resulting type after dereferencing.

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

Dereferences the value.

impl Drop for Bin

fn drop(&mut self)

Executes the destructor for this type.

impl Eq for Bin

impl Hash for Bin

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, 

Feeds a slice of this type into the given Hasher.

impl Into<Bin> for SBin

Returns the un-synchronized view of this binary. (so it's the same as IntoUnSyncView; NOT IntoUnSync).

fn into(self) -> Bin

Performs the conversion.

impl Into<Vec<u8>> for Bin

fn into(self) -> Vec<u8>

Performs the conversion.

impl<'a> IntoIterator for &'a Bin

type Item = &'a u8

The type of the elements being iterated over.

type IntoIter = Iter<'a, u8>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl IntoIterator for Bin

type Item = u8

The type of the elements being iterated over.

type IntoIter = IntoIter<Bin>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl IntoSync for Bin

type Target = SBin

fn into_sync(self) -> Self::Target

Converts this into a synchronized version.

impl IntoUnSync for Bin

This might actually do something, since this Bin could just be an un-synchronized view for a synchronized binary. In that case, the binary is converted.

type Target = Bin

fn un_sync_convert(self) -> Self::Target

Converts self into the un-synchronized version.

impl IntoUnSyncView for Bin

This does nothing, since Bin is already un-synchronized (view). Just returns itself.

type Target = Bin

fn un_sync(self) -> Self::Target

Returns the un-synchronized view of self.

impl LowerHex for Bin

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

Formats the value using the given formatter.

impl Ord for Bin

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

#[must_use]fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

#[must_use]fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

#[must_use]fn clamp(self, min: Self, max: Self) -> Self

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

Restrict a value to a certain interval.

impl PartialEq<Bin> for Bin

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 PartialOrd<Bin> for Bin

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

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

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

This method tests less than (for self and other) and is used by the < operator.

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

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

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

This method tests greater than (for self and other) and is used by the > operator.

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

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

impl UnSyncRef for Bin

This does nothing, since Bin is already un-synchronized (view). Just returns itself.

type Target = Bin

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

Returns the un-synchronized view of self (as reference).

impl UnsafeBin for Bin

unsafe fn _new(data: BinData, fn_table: &'static FnTable) -> Self

New binary from given data with given function table.

unsafe fn _data(&self) -> &BinData

A reference to the binary data.

unsafe fn _data_mut(&mut self) -> &mut BinData

A mutable reference to the binary data.

unsafe fn _fn_table(&self) -> &'static FnTable

Gets the function-table.

unsafe fn _into_sync(self) -> SBin

Wraps this binary in a sync-binary. This will just be a view (it does not synchronize). So be sure the actual implementation (the function table) is really Send + Sync.

impl UpperHex for Bin

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

Formats the value using the given formatter.