Struct Reader 

pub struct Reader<'a> {
    pub wide_seen: bool,
    /* private fields */
}

A reader of a resource’s fields, little-endian, that knows the block structure.

Fields

wide_seen: bool

A UTF-16 System::String was read (older builds write every string that way).

Implementations

impl<'a> Reader<'a>

pub fn new(data: &'a [u8]) -> Self

A reader at the start of data.

pub fn set_reference_ids(&mut self, ids: Arc<BTreeMap<u32, String>>)

Read external pointers as reference ids (ExternalFactory reference mode, used by saves).

pub fn pos(&self) -> usize

The current position, in bytes.

pub fn remaining(&self) -> usize

The number of bytes left before the end of the readable range.

pub fn slice(&self, start: usize, end: usize) -> Result<&'a [u8]>

Bytes already read or ahead, by absolute position.

pub fn bytes(&mut self, n: usize) -> Result<&'a [u8]>

The next n bytes.

pub fn u8(&mut self) -> Result<u8>

Read a u8.

pub fn bool(&mut self) -> Result<bool>

Read a bool (one byte, not zero is true).

pub fn u32(&mut self) -> Result<u32>

Read a u32.

pub fn i32(&mut self) -> Result<i32>

Read an i32.

pub fn u64(&mut self) -> Result<u64>

Read a u64.

pub fn i64(&mut self) -> Result<i64>

Read an i64.

pub fn i16(&mut self) -> Result<i16>

Read an i16.

pub fn u16(&mut self) -> Result<u16>

Read a u16.

pub fn limit(&mut self, end: usize) -> Result<usize>

Narrow the readable range to end at end (inside the current one); returns the old end for Reader::unlimit.

pub fn unlimit(&mut self, end: usize)

Restore the readable range that limit returned.

pub fn set_pos(&mut self, pos: usize)

Move to a position.

pub fn u32_at(&self, at: usize) -> Option<u32>

The u32 at an absolute offset.

pub fn peek_u32(&self) -> Option<u32>

The next u32 without consuming it (None at the end).

pub fn wstring(&mut self) -> Result<String>

A u32 count of UTF-16 units, the terminating NUL included (0 for an empty string), then the units.

Original: System::String::Serialize, Runtime 0x1800cc1a0.

pub fn f32(&mut self) -> Result<f32>

Read an f32.

pub fn f32s<const N: usize>(&mut self) -> Result<[f32; N]>

Read N f32 values.

pub fn count(&mut self) -> Result<usize>

Element count; rejects negative values.

pub fn string(&mut self) -> Result<String>

Read a string: a length with bit 31 set for 8-bit text (else UTF-16), then the characters with the terminating zero.

pub fn external_ref(&mut self) -> Result<Option<String>>

ExternalPtr: bool present, then a Path\File.rsc:object reference.

pub fn block<T>( &mut self, f: impl FnOnce(&mut Self, u32) -> Result<T>, ) -> Result<T>

Read one block, running f over its payload. Fails unless f consumes it exactly.

pub fn skip_rest(&mut self)

Skip the rest of the current block (for partially decoded types).

pub fn skip_block(&mut self) -> Result<()>

Skip a block without interpreting it.