Module binary_cursor

A low-level binary parsing interface with position tracking and error handling.

This module implements a binary parser that maintains a position stack and provides type-safe parsing methods for common binary formats. It handles errors through a custom error type that wraps I/O errors and provides detailed error messages.

The implementation includes:

• Position management with push/pop operations
• Safe parsing of primitive types (u8, u16, u32, f32)
• RAII-based temporary position changes via BinaryCursorJump
• Error handling with custom error types

Safety

All parsing operations are bounds-checked and will return errors rather than panicking on invalid input or out-of-bounds access.

Structs

BinaryCursor

A cursor-like interface for parsing binary data

BinaryCursorJump

A helper type for temporary position changes

Enums

BinaryCursorError

Error type for binary cursor operations