|GNU Octave Manual Version 3|
by John W. Eaton, David Bateman, Søren Hauberg
Paperback (6"x9"), 568 pages
RRP £24.95 ($39.95)
11.7.1 Manipulating the load path
When a function is called, Octave searches a list of directories for
a file that contains the function declaration. This list of directories
is known as the load path. By default the load path contains
a list of directories distributed with Octave plus the current
working directory. To see your current load path call the
function without any input or output arguments.
It is possible to add or remove directories to or from the load path
rmpath. As an example, the following
code adds ‘~/Octave’ to the load path.
After this the directory ‘~/Octave’ will be searched for functions.
- Built-in Function: addpath (dir1, ...)
- Built-in Function: addpath (dir1, ..., option)
- Add dir1, ... to the current function search path. If
option is ‘"-begin"’ or 0 (the default), prepend the
directory name to the current path. If option is ‘"-end"’
or 1, append the directory name to the current path.
Directories added to the path must exist.
See also path, rmpath, genpath, pathdef, savepath, pathsep
- Built-in Function: genpath (dir)
- Return a path constructed from dir and all its subdirectories.
- Built-in Function: rmpath (dir1, ...)
- Remove dir1, ... from the current function search path.
See also path, addpath, genpath, pathdef, savepath, pathsep
- Function File: savepath (file)
- Save the current function search path to file. If file
is omitted, ‘~/.octaverc’ is used. If successful,
See also path, addpath, rmpath, genpath, pathdef, pathsep
- Built-in Function: path (...)
- Modify or display Octave's load path.
If nargin and nargout are zero, display the elements of Octave's load path in an easy to read format.
If nargin is zero and nargout is greater than zero, return the current load path.
If nargin is greater than zero, concatenate the arguments, separating them with
pathsep(). Set the internal search path to the result and return it.
No checks are made for duplicate elements.
See also addpath, rmpath, genpath, pathdef, savepath, pathsep
- Built-in Function: val = pathdef ()
- Return the default list of directories in which to search for function
See also path, addpath, rmpath, genpath, savepath, pathsep
- Built-in Function: pathsep ()
- Return the system-dependent character used to separate directories in
See also filesep, dir, ls
- Built-in Function: rehash ()
- Reinitialize Octave's load path directory cache.
- Built-in Function: file_in_loadpath (file)
- Built-in Function: file_in_loadpath (file, "all")
Return the absolute name of file if it can be found in the list of directories specified by
path. If no file is found, return an empty matrix.
If the first argument is a cell array of strings, search each directory of the loadpath for element of the cell array and return the first that matches.
If the second optional argument
"all"is supplied, return a cell array containing the list of all files that have the same name in the path. If no files are found, return an empty cell array.
See also file_in_path, path
|ISBN 095461206X||GNU Octave Manual Version 3||See the print edition|