module::displace -- unloads a
module
Introductionmodule::displace(name) unloads a dynamic
module.
Call(s)module::displace(name <, Force>)
module::displace()
Parametersname |
- | module name: character string, identifier or module domain |
OptionsForce |
- | forces the module manager to unload a static module. |
Returnsthe void object of type DOM_NULL.
Side
EffectsThe machine code of modules is unloaded transparently to the user. It especially does not affect the module domains. The machine code is reloaded automatically if it is needed later.
The function reset
unloads all dynamic modules.
Related
Functionsexternal, loadmod, module::age, module::new, module::stat, unloadmod
Detailsmodule::displace(name) uses the kernel
function unloadmod
to unload a module.
Example
1Dynamic Modules can be unloaded at runtime to save memory resources or to change and re-compile it (rapid prototyping). However, its machine code is reloaded on demand.
>> module("stdmod"):
module::displace(stdmod):
stdmod::which("stdmod")
"/usr/local/mupad/linux/modules/stdmod.mdm"
Background