## `module::load` -- loads a module

#### Introduction

`module::load``(name)` loads a dynamic module and creates a corresponding module domain.

#### Call(s)

`module::load(name)`

#### Parameters

`name` | - | module name: character string or identifier

#### Returns

a module domain of type `DOM_DOMAIN`.

#### Side Effects

If `module::load``(name)` successfully loads a dynamic modules, it creates a corresponding module domain and assigns it to the identifier `name`.

#### Related Functions

`external`, `loadmod`, `module::age`, `module::displace`, `module::new`, `module::max`, `module::stat`, `unloadmod`

#### Details

- `module(name)` is an abbreviation for `module::``module::load``(name)`.
- `module::load``(name)` uses the kernel function `loadmod` to load a module.

#### Example 1

This example loads a dynamic module. Since a module is represented as a `domain`, it can be used in the same way as library packages or other MuPAD domains. Module online documentation can be displayed with the function `module::help`.

    >> module("stdmod")

                                      stdmod

    >> stdmod::which("stdmod")

          "/usr/local/mupad/linux/modules/stdmod.mdm"

    >> type(stdmod); info(stdmod)

                                    DOM_DOMAIN

          Module: 'stdmod' created on 16.Oct.00 by mmg R-2.0.0
          Module: Extended Module Management
          - Interface:
          stdmod::age,  stdmod::doc,   stdmod::help, stdmod::max,
          stdmod::stat, stdmod::which

    >> export(stdmod): which("stdmod")

          "/usr/local/mupad/linux/modules/stdmod.mdm"

#### Background

- More detailed information are available with the kernel functions `loadmod`, `unloadmod` and `external`.

Do you have questions or comments?
Copyright © SciFace Software GmbH & Co. KG 2000