File class for Nand2Tetris Virtual Machine Emulator

Class File allows programs running in the VMEmulator to read and write data on the host computer's disk.

Access to the host computer's disk is limited to files in or below a directory on the host's file system that is the VME's mount point.

By default, the mount point is nand2tetris/tools/VmeFileSystem, assuming VMEmulator is installed in nand2tetris/tools. The mount point can be overridden with the VMEFSROOT environment variable.

Possible uses for Jack programs to read and write files on the host might be for a game to save high score information, or for the very ambitious, rewrite the Assembler, VM translator and Jack compiler in Jack and run them on the VM emulator.

Example usage — copying a file

function void copyFile(String src, String dest) {
    var File fin, fout;
    var char c;

    let fin = File.new();
    if (fin.open(src, false)) {
        let fout = File.new();
        if (fout.open(dest, true)) {
            while ( ~ fin.eof()) {
                let c = fin.readByte();
                do fout.writeByte(c);
            }
        }
        do fout.close();
        do fout.dispose();
    }
    do fin.close();
    do fin.dispose();
    return;
}

Function Reference