Enum RawData

pub enum RawData<'a> {
    Single(&'a [u8]),
    Split(&'a [u8], &'a [u8]),
}

A slice of u8 data that can have non-contiguous backing storage split into two pieces, and abstracts that split away so that users can pretend to deal with a contiguous slice.

When reading perf events from the mmap’d fd that contains the perf event stream, it often happens that a single record straddles the boundary between two mmap chunks, or is wrapped from the end to the start of a chunk.

Variants

Single(&'a [u8])

Split(&'a [u8], &'a [u8])

Implementations

impl<'a> RawData<'a>

pub fn empty() -> Self

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

pub fn read_u64<T: ByteOrder>(&mut self) -> Result<u64, Error>

pub fn read_u32<T: ByteOrder>(&mut self) -> Result<u32, Error>

pub fn read_i32<T: ByteOrder>(&mut self) -> Result<i32, Error>

pub fn read_u16<T: ByteOrder>(&mut self) -> Result<u16, Error>

pub fn read_u8(&mut self) -> Result<u8, Error>

pub fn read_string(&mut self) -> Option<RawData<'a>>

Finds the first nul byte. Returns everything before that nul byte. Sets self to everything after the nul byte.

pub fn split_off_prefix(&mut self, n: usize) -> Result<Self, Error>

Returns the first n bytes, and sets self to the remainder.

pub fn skip(&mut self, n: usize) -> Result<(), Error>

pub fn as_slice(&self) -> Cow<'a, [u8]>

pub fn get(&self, range: Range<usize>) -> Option<RawData<'a>>

pub fn is_empty(&self) -> bool

pub fn len(&self) -> usize

Trait Implementations

impl<'a> Clone for RawData<'a>

fn clone(&self) -> RawData<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RawData<'_>

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

Formats the value using the given formatter.

impl<'a> From<&'a [u8]> for RawData<'a>

fn from(bytes: &'a [u8]) -> Self

Converts to this type from the input type.

impl<'a> From<&'a Cow<'a, [u8]>> for RawData<'a>

fn from(data: &'a Cow<'a, [u8]>) -> Self

Converts to this type from the input type.

impl<'a> PartialEq for RawData<'a>

fn eq(&self, other: &RawData<'a>) -> bool

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

const 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<'a> Copy for RawData<'a>

impl<'a> Eq for RawData<'a>

impl<'a> StructuralPartialEq for RawData<'a>