Enum RomError 

#[non_exhaustive]
pub enum RomError {
    Truncated {
        needed: usize,
        got: usize,
    },
    BadMagic,
    FdsUnsupported,
    UnsupportedMapper(u16),
    InvalidConfig(String),
}

Errors returned by crate::parse.

Marked #[non_exhaustive] so new variants can be added without breaking downstream match arms.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Truncated

File ended before the header / declared sections finished loading.

Fields

needed: usize

Minimum number of bytes required to satisfy the header.

got: usize

Number of bytes actually present.

BadMagic

Magic bytes did not match "NES\x1A".

FdsUnsupported

The file is a Famicom Disk System disk image (fwNES "FDS\x1A" header or a raw "*NINTENDO-HVC*" disk side), handed to the CARTRIDGE parser. FDS is supported since v2.2.0, but as a separate sub-platform: a disk loads through rustynes_core::Nes::from_disk together with the disksys.rom BIOS, which the desktop and web frontends do. It is detected here so a host without that path (the mobile apps, which load iNES / NES 2.0 only) shows a clear message instead of a generic bad-magic error. Until v2.7.5 the message still said FDS was “planned for v2.2.0” (core audit §4.7).

UnsupportedMapper(u16)

Mapper id is outside the coverage matrix for this build.

InvalidConfig(String)

The header parsed but encoded an internally inconsistent configuration (e.g., trainer flag set on a NES 2.0 ROM that has no trainer bytes).

Trait Implementations

impl Debug for RomError

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

Formats the value using the given formatter.

impl Display for RomError

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

Formats the value using the given formatter.

impl Error for RomError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.