Struct RimIndex 

pub struct RimIndex<R = File> { /* private fields */ }

A lazily-read RIM archive.

Holds the archive’s key table and reserved header fields; resource bytes are read from the backing source on each request.

Implementations

impl RimIndex<File>

pub fn open(path: impl AsRef<Path>) -> Result<Self, RimBinaryError>

Opens an archive from disk and indexes it.

Errors

The same as Self::open_with_options under the default options.

pub fn open_with_options( path: impl AsRef<Path>, options: RimReadOptions, ) -> Result<Self, RimBinaryError>

Opens an archive from disk with explicit read options.

Errors

RimBinaryError::Io when path will not open or its length cannot be read, and whatever Self::new_with_options reports for the file it opened.

impl<R: Read + Seek> RimIndex<R>

pub fn new(section: SectionReader<R>) -> Result<Self, RimBinaryError>

Indexes the archive occupying section.

Errors

The same as Self::new_with_options under the default options.

pub fn new_with_options( section: SectionReader<R>, options: RimReadOptions, ) -> Result<Self, RimBinaryError>

Indexes the archive occupying section with explicit read options.

Reads the header and key table immediately. A table that will not parse fails here, because nothing about the archive is knowable without it. An entry whose declared byte range escapes the archive does not: it is marked with a defect and the rest stays readable.

Errors

RimBinaryError::InvalidHeader when the header or key table escapes the section’s bounds, and RimBinaryError::InvalidMagic or RimBinaryError::InvalidVersion for a signature or version options.input does not accept. A zero keys_offset is one of these under StrictExplicitOffsets and not under CanonicalK1.

RimBinaryError::InvalidData when a key entry will not parse, RimBinaryError::InvalidResRef for an entry name that is not a valid resref, RimBinaryError::TextDecoding for a name that is not valid text in the archive’s encoding, and RimBinaryError::Io when the backing source fails.

pub fn resolve( &self, resref: &ResRef, resource_type: ResourceTypeCode, ) -> Result<Option<Vec<u8>>, RimBinaryError>

Reads the bytes of the resource named resref with resource_type.

Returns Ok(None) when the archive holds no such resource.

Errors

Only once the lookup has matched, so an error here means a damaged archive rather than a miss: the terms Self::read_entry gives.

pub fn read_entry(&self, index: usize) -> Result<Vec<u8>, RimBinaryError>

Reads the bytes of the entry at index in table order.

Errors

RimBinaryError::InvalidData when index is past the end of the table or the backing read comes up short, RimBinaryError::InvalidHeader when the entry carries the defect Self::new_with_options leaves on one whose range escapes the archive, and RimBinaryError::Io when the source fails.

pub fn entry_section(&self, index: usize) -> Option<SectionReader<R>>

Returns a window over the entry’s bytes without reading them.

Returns None when index is out of range or the entry carries a defect.

pub fn resource_section( &self, resref: &ResRef, resource_type: ResourceTypeCode, ) -> Option<SectionReader<R>>

Returns a window over the named resource’s bytes without reading them.

pub fn iter_resources( &self, ) -> impl Iterator<Item = Result<(&RimIndexEntry, Vec<u8>), RimBinaryError>> + '_

Iterates every resource, pairing its entry with freshly-read bytes.

Each item is read on demand, so a caller that stops early pays only for what it consumed.

impl<R> RimIndex<R>

pub fn entries(&self) -> &[RimIndexEntry]

Returns the indexed entries in table order.

pub fn len(&self) -> usize

Returns the number of indexed resources.

pub fn is_empty(&self) -> bool

Returns whether the archive holds no resources.

pub fn contains(&self, resref: &ResRef, resource_type: ResourceTypeCode) -> bool

Returns whether the archive holds the named resource.

True even when the entry is defective: the archive claims the resource exists, it just cannot be read.

pub fn defects( &self, ) -> impl Iterator<Item = (usize, &RimIndexEntry, &EntryDefect)> + '_

Iterates the entries that cannot be read, with their table positions.

Whatever mounts this archive is expected to surface these rather than let a partially-readable archive pass as intact.

pub fn has_defects(&self) -> bool

Returns whether any entry in the archive is unreadable.

pub fn reserved_0x08(&self) -> u32

Returns the reserved header word at 0x08.

Preserved so a writer can reproduce the archive’s header verbatim.

pub fn reserved_0x14(&self) -> u32

Returns the reserved header word at 0x14.

pub fn reserved_0x18(&self) -> &[u8; 96]

Returns the reserved header block at 0x18.

Trait Implementations

impl<R: Debug> Debug for RimIndex<R>

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

Formats the value using the given formatter.