Struct MarcReader

Source

pub struct MarcReader { /* private fields */ }

Expand description

Unified MARC reader with auto-detection of file format (binary ISO2709 or MARC-XML).

Internally, all data is stored as ISO2709 bytes. XML input is eagerly converted by XmlReader::parse(), so iteration always goes through BinaryReader.

Implementations§

Source §

impl MarcReader

Source

pub fn from_bytes(data: Vec<u8>) -> Result<Self, MarcError>

Auto-detect format from raw bytes and build the reader. XML data is eagerly converted to ISO2709.

Source

pub fn from_file(path: &Path) -> Result<Self, MarcError>

Read a file, auto-detect its format, and build the reader.

Source

pub fn from_binary(data: Vec<u8>) -> Self

Force binary ISO2709 format (no detection).

Source

pub fn from_xml(data: &[u8]) -> Result<Self, MarcError>

Force MARC-XML format (no detection). Parses XML eagerly into ISO2709.

Source

pub fn with_encoding(self, encoding: Encoding) -> Self

Force the encoding used when decoding raw record data. Use when the record’s declared encoding (e.g. leader byte 9 for MARC21, 100$a for UNIMARC) is wrong.

Source

pub fn clear_encoding_override(&mut self)

Clear any encoding override.

Source

pub fn source_format(&self) -> FileFormat

Returns the original file format before conversion.

Source

pub fn encoding_override(&self) -> Option<Encoding>

Returns the encoding override when set.

Source

pub fn iter(&self) -> BinaryReader<'_> ⓘ

Iterate over raw ISO2709 records (with optional encoding override applied when decoding).

Source

pub fn as_bytes(&self) -> &[u8] ⓘ

Raw ISO2709 bytes (useful for direct binary output).

Source

pub fn into_records(self) -> Result<Vec<Record>, MarcError>

Parse all records into the high-level semantic model. If with_encoding() was used, that encoding is applied instead of the one detected from each record.