11.9.1 Управление путём загрузки

При вызове функции Octave ищет файл, содержащий объявление функции, в списке каталогов. Этот список каталогов известен как путь загрузки. По умолчанию путь загрузки содержит список каталогов, поставляемых с Octave, плюс текущий рабочий каталог. Чтобы увидеть текущий путь загрузки, вызовите функцию path без входных или выходных аргументов.

Добавить или удалить каталоги из пути загрузки можно с помощью addpath и rmpath. В качестве примера, следующий код добавляет ‘~/Octave’ в путь загрузки.

addpath ("~/Octave")

После этого каталог ‘~/Octave’ будет просматриваться при поиске функций.

addpath (dir1, …)

addpath (dir1, …, option)

Добавить указанные каталоги в путь поиска функций.

Если option является "-begin" или 0 (по умолчанию), имя каталога добавляется в начало текущего пути. Если option является "-end" или 1, имя каталога добавляется в конец текущего пути. Каталоги, добавленные в путь, должны существовать.

Помимо отдельных аргументов каталогов, также принимаются списки имён каталогов, разделённые pathsep. Например:

addpath ("dir1:/dir2:~/dir3")

Для каждого добавленного каталога, которого ещё не было в пути, addpath проверяет наличие файла с именем PKG_ADD (обратите внимание на отсутствие расширения .m) и выполняет его, если он существует.

См. также: path, rmpath, genpath, pathdef, savepath, pathsep.

genpath (dir)

genpath (dir, skip, …)

Возвратить путь, построенный из dir и всех его подкаталогов.

Путь не включает каталоги пакетов (начинающиеся с ‘+’), каталоги классов старого стиля (начинающиеся с ‘@’), каталоги private или любые подкаталоги этих типов.

Если предоставлены дополнительные строковые параметры, полученный путь будет исключать каталоги с этими именами.

См. также: path, addpath.

rmpath (dir1, …)

Удалить dir1, … из текущего пути поиска функций.

Помимо отдельных аргументов каталогов, также принимаются списки имён каталогов, разделённые pathsep. Например:

rmpath ("dir1:/dir2:~/dir3")

Для каждого удалённого каталога, rmpath проверяет наличие файла с именем PKG_DEL (обратите внимание на отсутствие расширения .m) и выполняет его, если он существует.

См. также: path, addpath, genpath, pathdef, savepath, pathsep.

savepath ()

savepath (file)

status = savepath (…)

Сохранить уникальную часть текущего пути поиска функций, которая не установлена во время инициализации Octave, в file.

Если file опущено, Octave ищет в текущем каталоге файл .octaverc для сохранения информации о пути. Если такого файла нет, используется конфигурационный файл пользователя ~/.octaverc.

При успешном выполнении, savepath возвращает 0.

Функция savepath упрощает настройку конфигурационного файла пользователя для восстановления необходимых путей для конкретного экземпляра Octave. Если имя файла не указано, Octave автоматически восстановит сохранённые пути каталогов из соответствующего файла .octaverc при запуске. Если имя файла указано, пути можно восстановить вручную, вызвав source file.

См. также: path, addpath, rmpath, genpath, pathdef.

path ()

str = path ()

str = path (path1, …)

Изменить или отобразить путь загрузки Octave.

Если nargin и nargout равны нулю, отобразить элементы пути загрузки Octave в удобном для чтения формате.

Если nargin равен нулю, а nargout больше нуля, вернуть текущий путь загрузки.

Если nargin больше нуля, конкатенировать аргументы, разделяя их pathsep. Установить внутренний путь поиска на результат и вернуть его.

Проверки на дубликаты элементов не выполняется.

См. также: addpath, rmpath, genpath, pathdef, savepath, pathsep.

val = pathdef ()

Возвратить стандартный путь для Octave.

Информация о пути извлекается из одного из четырёх источников. Возможные источники, в порядке предпочтения:

1. .octaverc
2. ~/.octaverc
3. <OCTAVE_HOME>/…/<version>/m/startup/octaverc
4. Путь Octave до изменений любым файлом octaverc.

См. также: path, addpath, rmpath, genpath, savepath.

val = pathsep ()

Запросить символ, используемый для разделения каталогов в пути.

См. также: filesep.

rehash ()

Переинициализировать кэш каталогов пути загрузки Octave.

fname = file_in_loadpath (file)

fname = file_in_loadpath (file, "all")

Возвратить абсолютное имя file, если он найден в списке каталогов, указанном path.

Если файл не найден, вернуть пустую строку.

Если file уже является абсолютным именем, имя проверяется на наличие в файловой системе вместо пути загрузки Octave. В этом случае, если file существует, он будет возвращён в fname, иначе возвращается пустая строка.

Если первый аргумент является массивом ячеек строк, искать каждый элемент массива ячеек в каталогах пути загрузки и возвращать первый совпавший элемент.

Если предоставлен второй необязательный аргумент "all", вернуть массив ячеек, содержащий список всех файлов с тем же именем в пути. Если файлы не найдены, вернуть пустой массив ячеек.

См. также: file_in_path, dir_in_loadpath, path.

restoredefaultpath ()

Восстановить путь Octave до его начального состояния при запуске.

См. также: path, addpath, rmpath, genpath, pathdef, savepath, pathsep.

command_line_path ()

Возвратить переменную пути командной строки.

См. также: path, addpath, rmpath, genpath, pathdef, savepath, pathsep.

dirname = dir_in_loadpath (dir)

dirname = dir_in_loadpath (dir, "all")

Возвратить абсолютное имя элемента пути загрузки, соответствующего dir, если он найден в списке каталогов, указанном path.

Если совпадение не найдено, вернуть пустую строку.

Совпадение выполняется в конце каждого элемента пути. Например, если dir это "foo/bar", он соответствует элементу пути "/some/dir/foo/bar", но не "/some/dir/foo/bar/baz" "/some/dir/allfoo/bar". Если dir является абсолютным именем, а не фрагментом пути, он сравнивается с файловой системой вместо пути загрузки Octave. В этом случае, если dir существует, он будет возвращен в dirname, в противном случае возвращается пустая строка.

Если предоставлен необязательный второй аргумент, вернуть массив ячеек, содержащий все совпадения имён, а не только первое.

См. также: file_in_path, file_in_loadpath, path.