Struct LazyDataSetReader 

pub struct LazyDataSetReader<S> { /* private fields */ }

An attached iterator for retrieving DICOM object element markers from a random access data source.

This iterator produces data tokens without eagerly reading the bytes of a value.

Implementations

impl<R> LazyDataSetReader<DynStatefulDecoder<R>>

pub fn new_with_ts(source: R, ts: &TransferSyntax) -> Result<Self>

where R: ReadSeek,

Create a new lazy data set reader expecting the given transfer syntax that reads from the given random access source.

pub fn new_with_ts_cs( source: R, ts: &TransferSyntax, cs: SpecificCharacterSet, ) -> Result<Self>

where R: ReadSeek,

Create a new lazy data set reader with the given random access source and element dictionary, while considering the given transfer syntax and specific character set.

pub fn new_with_ts_options( source: R, ts: &TransferSyntax, options: LazyDataSetReaderOptions, ) -> Result<Self>

where R: ReadSeek,

Create a new lazy data set reader expecting the given transfer syntax that reads from the given random access source, with extra parsing options.

pub fn new_with_ts_cs_options( source: R, ts: &TransferSyntax, cs: SpecificCharacterSet, options: LazyDataSetReaderOptions, ) -> Result<Self>

where R: ReadSeek,

Create a new lazy data set reader with the given random access source and element dictionary, while considering the given transfer syntax and specific character set.

impl<S> LazyDataSetReader<S>

where S: StatefulDecode,

pub fn new(parser: S) -> Self

Create a new iterator with the given stateful decoder.

pub fn new_with_options(parser: S, options: LazyDataSetReaderOptions) -> Self

where S: StatefulDecode,

Create a new lazy data set reader using the given stateful decoder, with extra parsing options.

impl<S> LazyDataSetReader<S>

where S: StatefulDecode,

pub fn into_decoder(self) -> S

Retrieve the inner stateful decoder from this data set reader.

pub fn advance(&mut self) -> Option<Result<LazyDataToken<&mut S>>>

Advance and retrieve the next DICOM data token.

Note: For the data set to be successfully parsed, the resulting data tokens needs to be consumed if they are of a value type.

pub fn peek(&mut self) -> Result<Option<&DataToken>>

Peek the next token from the source by reading a new token in the first call. Subsequent calls to peek will return the same token until another consumer method is called.

Peeking only works in a data or item element boundary, so the returned data token is either an element header or an item header. At the moment, a failed peek will result in a hard break, preventing further iteration.

Trait Implementations

impl<S: Debug> Debug for LazyDataSetReader<S>

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

Formats the value using the given formatter.