Struct RawDataElementView 

pub struct RawDataElementView<'a> {
    pub offset: u64,
    pub header: RecordHeader,
    pub raw_data: &'a [u8],
    pub byte_order: ByteOrder,
}

Element yielded by RawDataViewIter. Unlike RawDataElement, it borrows the unprocessed record bytes from the iterator’s reused buffer, so it’s only valid until the next call to RawDataViewIter::next.

In return, it offers better performance and lower heap footprints.

It can be converted to StdfRecord, borrowed as StdfRecordView, or copied into an owned RawDataElement when it needs to outlive the current iteration scope.

use rust_stdf::{RawDataElementView, ByteOrder, StdfRecord, RecordHeader, stdf_record_type::REC_FAR};

let raw = [0u8; 0];
let rdv = RawDataElementView {
    offset: 0,
    header: RecordHeader {typ: 0, sub: 10, len: 2},
    raw_data: &raw,
    byte_order: ByteOrder::LittleEndian
};
let rec: StdfRecord = (&rdv).into();
println!("{:?}", rec);
assert!(rec.is_type(REC_FAR));

Fields

offset: u64

file offset of raw_data in file, after header.len and before raw_data

|-typ-|-sub-|–len–⬇️–raw..data–|

note that the offset is relative to the file position that runs get_rawdata_view_iter,

it can be treated as file position only if the iteration starts from beginning of the file.

header: RecordHeader

used for identifying StdfRecord types

raw_data: &'a [u8]

field data of current STDF Record, borrowed from the iterator’s reused buffer

byte_order: ByteOrder

Implementations

impl RawDataElementView<'_>

pub fn is_type(&self, rec_type: u64) -> bool

Trait Implementations

impl<'a> Clone for RawDataElementView<'a>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for RawDataElementView<'a>

impl<'a> Debug for RawDataElementView<'a>

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

Formats the value using the given formatter.

impl<'a> Eq for RawDataElementView<'a>

impl From<&RawDataElementView<'_>> for StdfRecord

fn from(raw_view: &RawDataElementView<'_>) -> Self

Parse the borrowed bytes into an owned record; does not consume the input.

impl From<&RawDataElementView<'_>> for RawDataElement

fn from(raw_view: &RawDataElementView<'_>) -> Self

Copy the borrowed bytes into an owned RawDataElement; does not consume the input.

impl<'a> From<&RawDataElementView<'a>> for StdfRecordView<'a>

fn from(raw_view: &RawDataElementView<'a>) -> Self

Build a zero-copy view; does not consume the input.

impl<'a> PartialEq for RawDataElementView<'a>

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

Equality operator ==.

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

Inequality operator !=.

impl<'a> StructuralPartialEq for RawDataElementView<'a>