NAME

save - save the OADL machine to the given filename

SYNOPSIS

oadl::save(fname)

DESCRIPTION

Saves the complete OADL state to the given fname; similar to setjmp(), a subsequent restore() will return control to this location.

RETURN VALUE

Returns true if the save succeeded, false if the save failed, and nil when a subsequent restore successfully returns the OADL state to what was saved.

ERRORS

TypeCheck if fname is not a packed character array
ShapeCheck if fname is not a single-dimensional String

EXAMPLE

    switch (oadl::save(fname)) {
    case false :
        "Save failed\n";
    case true :
        "Save to ", fname, " succeeded\n";
    case nil :
        "Restored state from ", fname, '\n';
    }

SEE ALSO

restore