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 a lower heap footprint.

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) -> RawDataElementView<'a>

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: &RawDataElementView<'a>) -> bool

Equality operator ==.

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

Inequality operator !=.

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