Enum DiskImage 

pub enum DiskImage<'a> {
    STX(STXDisk<'a>),
    Apple(AppleDisk<'a>),
}

DiskImage is the primary enumeration for holding disk images.

The DiskImageParser and DiskImageSaver trait functions return and operate on this enumeration.

Because the Disk data structures are more intelligent than simple byte-oriented C structures, copying them isn’t as easy as copying a block of bytes. rust-clippy recommends boxing the large fields to reduce the total size of the enum. This is a new recommendation, we’ll ignore it for now and investigate other solution. DiskImage construction is usually done once at the beginning of the program, and total variant size is still around ~512 bytes On normal invocations in the current codebase we only have one instance of this enum. Future versions may have more, but for now the cost is not an issue. If this code is adapted to process a large number of images and thrashing is a concern, feel free to fix it.

Variants

STX(STXDisk<'a>)

An Atari ST STX Disk Image. Usually the raw data in a STX disk image is a FAT12 filesystem.

Apple(AppleDisk<'a>)

An Apple ][ Disk Image There are several different encodings, formats, and filesystems for Apple2 disks. This includes nibble encoding and DOS 3.x and ProDOS filesystems.

Trait Implementations

impl<'a, 'b> DiskImageOps<'a, 'b> for DiskImage<'a>

fn catalog(&'a self, _config: &'b Config) -> Result<String, Error>

This function lists the contents of the disk It simply returns the root directory as a string Future versions could provide more structure

impl DiskImageSaver for DiskImage<'_>

fn save_disk_image( &self, config: &Config, selected_filename: Option<&str>, filename: &str, ) -> Result<(), Error>

Save the primary data contents of a disk image to disk The meaning of the data contents will differ between image formats, but it’s usually all the volume, track, and sector data, or the enclosed file format if the outer image is a wrapper. This function parses an entire disk, returning a DiskImage.

impl Display for DiskImage<'_>

Display a DiskImage

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

Formats the value using the given formatter.