
loadmod - loads a modul

Calling sequence:
loadmod(string)

Parameter:

string   --  character string

Summary:

loadmod loads the modul string and, analogue to the loading of a MuPAD
library with the function loadlib , defines a modul-domain with the same
name.  This contains the function identifiers of the modul function.  If the
identifier string has already been defined then it is assigned a new value
and a warning is returned. loadmod is a function of the system kernel and
returns the return value of the newly defined modul domain.

If string is not a statically bound pseudo modul then the modul file string.mdm
is searched for firstly in the directories defined by the variable READ_PATH then
in the current directory and finally in the MuPAD modul directory.  If the
modul cannot be loaded then the calculation being carried out is terminated
with an error message.

If the file string.mdg to the modul exists then it contains MuPAD objects
that are likewise loaded and bound to the function environment of the modul

function. If an error occurs while these objects are being loaded a warning
is given and MuPAD tries once more to load the object at each call of the
modul functions affected by it.

At every further call of loadmod the machine code of the modul is only then
re-loaded when it has been previously automatically discarded or removed
from memory with the system function unloadmod  by the user. With each
new successful call the modul is newly defined and if necessary the objects
of the file string.mdg are re-loaded.

Apart from the modul file string.mdm there may also be a text file string.mdh.
This contains a short description of the modul and can be accessed with the
library function module::help.

>>  loadmod("stdmod");

      stdmod

See also:  export , external , info, unloadmod , READ_PATH

