load -- r7rs Definition

§

Kind

§

procedure;

Implemented by

§

• load (from vonuvoli);

Procedure signature

§

Procedure variants:

• ((path-string) -> (undefined))
  • input: a value of type path-string;
  • output: a value of type undefined;
• ((path-string eval-environment) -> (undefined))
  • inputs:
    • a value of type path-string;
    • a value of type eval-environment;
  • output: a value of type undefined;

Exports

§

• scheme:load -- (scheme load);

Exports recursive

§

• scheme -- (scheme);

Description

§

(load filename)
(load filename environment-specifier)

Domain: It is an error if filename is not a string.

An implementation-dependent operation is used to transform filename into the name of an existing file containing Scheme source code. The load procedure reads expressions and definitions from the file and evaluates them sequentially in the environment specified by environment-specifier. If environment-specifier is omitted, (interaction-environment) is assumed.

It is unspecified whether the results of the expressions are printed. The load procedure does not affect the values returned by current-input-port and current-output-port. It returns an unspecified value.

Rationale: For portability, load must operate on source files. Its operation on other kinds of files necessarily varies among implementations.

---

The text herein was sourced and adapted as described in the "R7RS attribution of various text snippets" appendix.

Referenced-types

§

• path-string;
• undefined;
• eval-environment;