Struct gimli::read::LineRows

pub struct LineRows<R, Program, Offset = <R as Reader>::Offset> where
    Program: LineProgram<R, Offset>,
    R: Reader<Offset = Offset>,
    Offset: ReaderOffset,  { /* fields omitted */ }

Executes a LineProgram to iterate over the rows in the matrix of line number information.

"The hypothetical machine used by a consumer of the line number information to expand the byte-coded instruction stream into a matrix of line number information." -- Section 6.2.1

Methods

impl<R, Program, Offset> LineRows<R, Program, Offset> where
    Program: LineProgram<R, Offset>,
    R: Reader<Offset = Offset>,
    Offset: ReaderOffset, 

pub fn header(&self) -> &LineProgramHeader<R, Offset>

Get a reference to the header for this state machine's line number program.

pub fn next_row(
    &mut self
) -> Result<Option<(&LineProgramHeader<R, Offset>, &LineRow)>>

Parse and execute the next instructions in the line number program until another row in the line number matrix is computed.

The freshly computed row is returned as Ok(Some((header, row))). If the matrix is complete, and there are no more new rows in the line number matrix, then Ok(None) is returned. If there was an error parsing an instruction, then Err(e) is returned.

Unfortunately, the references mean that this cannot be a FallibleIterator.

Trait Implementations

impl<R: Debug, Program: Debug, Offset: Debug> Debug for LineRows<R, Program, Offset> where
    Program: LineProgram<R, Offset>,
    R: Reader<Offset = Offset>,
    Offset: ReaderOffset, 

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

Formats the value using the given formatter.

impl<R: Clone, Program: Clone, Offset: Clone> Clone for LineRows<R, Program, Offset> where
    Program: LineProgram<R, Offset>,
    R: Reader<Offset = Offset>,
    Offset: ReaderOffset, 

fn clone(&self) -> LineRows<R, Program, Offset>

Returns a copy of the value.

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

Performs copy-assignment from source.