Struct Library 

pub struct Library {
    pub programs: Vec<Program>,
    pub dirs: Vec<PathBuf>,
    pub copy: Libraries,
    pub flags: Vec<String>,
    pub trace_statements: Option<StatementFilter>,
    pub trace_input: bool,
    pub statement_limit: Option<u64>,
    pub screen: Option<Rc<RefCell<Crt>>>,
    pub environment: BTreeMap<String, String>,
    pub time_limit: Option<u64>,
    pub storage_limit: Option<u64>,
    pub program_ids: Option<Vec<(String, PathBuf)>>,
}

Where CALL finds programs: the other programs of the first program’s source, then program libraries searched by member name.

Fields

programs: Vec<Program>

The programs not yet loaded: the first program’s source’s own, then those read from a library file, which name that file as their first source.

dirs: Vec<PathBuf>

copy: Libraries

flags: Vec<String>

trace_statements: Option<StatementFilter>

The statements whose start the run unit tells its observer of (RunUnit::statements).

trace_input: bool

Whether the run unit follows which bytes may hold input (RunUnit::taint).

statement_limit: Option<u64>

How many statements may start before the run ends with S322 (RunUnit::statement_limit).

screen: Option<Rc<RefCell<Crt>>>

The screen positioned DISPLAY and ACCEPT use, with the operator a screen script plays; None gives each run a blank screen with no operator.

environment: BTreeMap<String, String>

The environment variables --env gives the run.

time_limit: Option<u64>

Seconds the run may take before it ends with S322 (RunUnit::limit).

storage_limit: Option<u64>

Bytes of storage the run unit may hold before the run ends (RunUnit::limit).

program_ids: Option<Vec<(String, PathBuf)>>

Each PROGRAM-ID the source files of dirs hold, with its file, read the first time a CALL names no member.

Implementations

impl Library

pub fn find(&mut self, name: &str) -> Option<&Program>

The program a CALL of name would load, parsed, not compiled, and kept for that CALL; None when no program answers it or its source does not parse.

pub fn add_read(&mut self, path: &Path, programs: Vec<Program>)

Keeps programs read from the library file path for a later CALL.

Trait Implementations

impl Clone for Library

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Library

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

Formats the value using the given formatter.

impl Default for Library

fn default() -> Self

Returns the “default value” for a type.

impl Loader<Rc<Compiled>> for Library

fn program( &mut self, name: &str, ) -> Result<LoadedProgram<Rc<Compiled>>, LoadError>

The program whose PROGRAM-ID CALL names, compiled.

fn holder(&self, entry: &str) -> Option<String>

The PROGRAM-ID of a program not yet loaded that has an ENTRY of this name.

fn entry(program: &Rc<Compiled>, name: &str) -> Option<usize>

Which of a loaded program’s ENTRY statements has this name.

fn shape(program: &Rc<Compiled>) -> (usize, usize)

A loaded program’s file count and storage size.

fn nested(program: &Rc<Compiled>) -> &[String]

The PROGRAM-IDs of the programs a loaded program contains, which a CANCEL of it reaches.

fn facts(program: &Rc<Compiled>) -> Facts

The statement kinds, usages and options a loaded program holds.

fn source(program: &Rc<Compiled>, file: usize) -> Option<String>

Source file file of a loaded program’s source table, by name.

fn class( &mut self, external: &str, ) -> Result<Option<FoundClass<Rc<ClassCode>>>, String>

The COBOL class definition of this external name, its data and methods each a program the executor runs; None for a Java class.

fn mapset(&mut self, name: &str) -> Option<Result<Mapset, String>>

A BMS mapset from the copy libraries, which SEND MAP and RECEIVE MAP read; None when no library holds it.