Overview

The MzLib utilities are not built into MzScheme and they are not already present after the stand-alone console version of MzScheme has loaded.

MzLib is broken into several small libraries. Each library is separately loaded using MzScheme's  require-library procedure. Using  require-library will ensure that each library is loaded only once, even if it is required multiple times. Some libraries automatically require other libraries. The utilities provided by each library and the other libraries it requires are detailed in the next chapter.

The non-macro parts of MzLib are written using signed units (see section 3.16). These libraries can be used through a unit, or the unit can be invoked and opened to use the utilities as top-level defintions. Non-macro libraries have four requireable files:

• (require-library "xs.ss") loads the signature of the unit for library x.
• (require-library "xu.ss") loads x as a unit, automatically requiring ``xs.ss''.
• (require-library "x.ss") requires ``xu.ss'' and opens the unit into the global environment.
• (require-library "xc.ss") requires ``x.ss'' and makes all of the names for x global constants.

All ``xu.ss'' files also require ``unit.ss'', which defines define-signature, unit-with-signature (unit/s), etc. The ``constant.ss'' collection is required by all ``xc.ss'' files.

Applications written in core Scheme will most likely use (require-library "x.ss"), while unit-based applications will use (require-library "xu.ss") and (require-library "xs.ss").

Some utility collections contain only macros, and therefore do not have the ``xu.ss'' and ``xs.ss'' files.

In all, MzLib contains the following requireable files:

• ``compat.ss'', ``compatu.ss'', ``compats.ss'', ``compatc.ss'' [CORE]
• ``constant.ss'', ``constantc.ss''
• ``date.ss'', ``dateu.ss'', ``dates.ss'', ``datec.ss''
• ``defstru.ss'', ``defstruc.ss'' [CORE]
• ``file.ss'', ``fileu.ss'', ``files.ss'', ``filec.ss'' [CORE]
• ``functio.ss'', ``functiou.ss'', ``functios.ss'', ``functioc.ss'' [CORE]
• ``macro.ss'', ``macroc.ss'' [CORE]
• ``match.ss'', ``matchc.ss'' [CORE]
• ``pconvert.ss'', ``pconveru.ss'', ``pconvers.ss'', ``pconverc.ss''
• ``pretty.ss'', ``prettyu.ss'', ``prettys.ss'', ``prettyc.ss'' [CORE]
• ``shared.ss'', ``sharedc.ss'' [CORE]
• ``spidey.ss'', ``spideyc.ss''
• ``string.ss'', ``stringu.ss'', ``strings.ss'', ``stringc.ss'' [CORE]
• ``synrule.ss'', ``synrule.ss'' [CORE]
• ``trigger.ss'', ``triggeru.ss'', ``triggers.ss'', ``triggerc.ss''
• ``unitsig.ss'', ``unitsigc.ss'' [CORE]
• ``zmath.ss'', ``zmathu.ss'', ``zmaths.ss'', ``zmathc.ss''

All of the libraries marked with [CORE] can be required at once by requiring ``core.ss'', ``coreu.ss'', ``cores.ss'', or ``corec.ss''. (For libraries without ``xu.ss'' files, ``coreu.ss'' requires ``x.ss''.) All MzLib libraries can be required at once by requiring ``mzlib.ss'', ``mzlibu.ss'', ``mzlibs.ss'', or ``mzlibc.ss''.