Scilab Website | Contribute with GitLab | Mailing list archives | ATOMS toolboxes
Scilab Online Help
2025.0.0 - English


atomsRemove

Remove one or several modules

Syntax

result = atomsRemove(modules)
result = atomsRemove(modules, section)
result = atomsRemove(.., delete)

Arguments

modules

mx1 or mx2 character string matrix:

1st Col. Technical name Mandatory
2nd Col. Version Optional If this field is empty or is not present, all versions of the module are removed.
section

This argument controls the list of sections where search modules to remove.

section is a single-string and its value should be :

  • "all": Modules to remove are searched in both "user" and "allusers" sections.

  • "allusers": Modules to remove are only searched in the "allusers" section.

  • "user": Modules to remove are only searched in the "user" section.

If SCI is write accessible, "all" is the default value. Otherwise, the default value is "user".

delete

delete is a boolean. If set to %T (True), the .zip or .tar.gz file containing the sources will also be deleted. This includes the dependencies' archives files that were installed with the module, if any.

result

5xn character string matrix:

1st Col. Technical name
2nd Col. Version
3rd Col. Installation section this parameter determines whether the module has been installed for all users or only for the current user.
4th Col. Installation path
5th Col. Status "I" stands for "Intentionally", "A" stands for "Automatically"

Description

atomsRemove remove one or more modules.

Examples

// Display some additional information
atomsSetConfig("Verbose","True");

// Load the test repository
atomsRepositoryAdd("https://scene2.test.atoms.scilab.org");

// install toolbox_4 : both 1.0 and 1.1 versions

// Remove all versions of a module
atomsInstall(["toolbox_4" "1.0";"toolbox_4" "1.1"],"user");
atomsRemove(["toolbox_4"]);

// Remove a specific version
atomsInstall(["toolbox_4" "1.0";"toolbox_4" "1.1"],"user");
atomsRemove(["toolbox_4" "1.0"]);
atomsRemove(["toolbox_4" "1.1"]);

// Remove several modules
atomsInstall(["toolbox_4";"toolbox_3"],"user");
atomsRemove(["toolbox_4";"toolbox_3"]);

// Remove a module from a specific section
// ! This example needs write access on SCI directory

atomsInstall("toolbox_4","user");
atomsInstall("toolbox_4","allusers");

disp(atomsGetInstalled());
atomsRemove("toolbox_4","user");
disp(atomsGetInstalled());
atomsRemove("toolbox_4","allusers");
disp(atomsGetInstalled());

// Remove a module, including its archive file

atomsInstall("toolbox_4");
atomsRemove("toolbox_4",%T);

// Remove a module from a specific section, including its archive file

atomsInstall("toolbox_4");
atomsRemove("toolbox_4","user",%T);

// Unload the test repository
atomsRepositoryDel("https://scene2.test.atoms.scilab.org");

See also

  • atomsInstall — Install one or several external modules
  • atomsIsInstalled — Determines whether the module is installed. Returns true if the module is installed, false otherwise.
  • atomsGetInstalled — Get the list of installed external modules
Report an issue
<< atomsQuit ATOMS atomsRepositoryAdd >>

Copyright (c) 2022-2024 (Dassault Systèmes)
Copyright (c) 2017-2022 (ESI Group)
Copyright (c) 2011-2017 (Scilab Enterprises)
Copyright (c) 1989-2012 (INRIA)
Copyright (c) 1989-2007 (ENPC)
with contributors
Last updated:
Thu Oct 24 11:13:15 CEST 2024