2.1.1 Параметры командной строки

Вот полный список параметров командной строки, которые принимает Octave.

--built-in-docstrings-file filename

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

--debug

-d

Включает режим отладки парсера. Использование этого параметра заставит парсер Octave выводить много информации о считываемых командах, и он, вероятно, полезен только при фактической отладке парсера.

--debug-jit

Включает отладку и трассировку компилятора JIT.

--doc-cache-file filename

Указывает имя файла кэша документации. Значение filename, заданное в командной строке, переопределит любое значение OCTAVE_DOC_CACHE_FILE в окружении, но не команды в системных или пользовательских файлах запуска, которые используют функцию doc_cache_file.

--echo-commands

-x

Выводить команды по мере их выполнения.

--eval code

Вычислить code и выйти, когда закончите, если не указан также --persist.

--exec-path path

Указывает путь для поиска программ для запуска. Значение path, заданное в командной строке, переопределит любое значение OCTAVE_EXEC_PATH в окружении, но не команды в системных или пользовательских файлах запуска, которые устанавливают встроенную переменную EXEC_PATH.

--gui

Запустить графический пользовательский интерфейс (GUI).

--help

-h

Вывести краткое сообщение справки и выйти.

--image-path path

Добавить путь в начало пути поиска для изображений. Значение path, заданное в командной строке, переопределит любое значение OCTAVE_IMAGE_PATH в окружении, но не команды в системных или пользовательских файлах запуска, которые устанавливают встроенную переменную IMAGE_PATH.

--info-file filename

Указывает имя файла информации. Значение filename, заданное в командной строке, переопределит любое значение OCTAVE_INFO_FILE в окружении, но не команды в системных или пользовательских файлах запуска, которые используют функцию info_file.

--info-program program

Указывает имя программы информации. Значение program, заданное в командной строке, переопределит любое значение OCTAVE_INFO_PROGRAM в окружении, но не команды в системных или пользовательских файлах запуска, которые используют функцию info_program.

--interactive

-i

Принудительно включить интерактивное поведение. Это может быть полезно для запуска Octave через удаленную команду оболочки или внутри буфера оболочки Emacs.

--jit-compiler

Включить компилятор JIT, используемый для ускорения циклов.

--line-editing

Принудительно использовать readline для редактирования командной строки.

--no-gui

Отключить графический пользовательский интерфейс (GUI) и использовать интерфейс командной строки (CLI) вместо него. Это поведение по умолчанию, но этот параметр может быть полезен для переопределения предыдущего --gui.

--no-history

-H

Отключить запись истории командной строки.

--no-init-file

Не читать файлы инициализации ~/.octaverc и .octaverc.

--no-init-path

Не инициализировать путь поиска для файлов функций, чтобы включить стандартные расположения.

--no-line-editing

Отключить редактирование командной строки.

--no-site-file

Не читать файлы инициализации octaverc для всего сайта.

--no-window-system

-W

Отключить использование системного окна, включая графику. Это принудительно создает среду только для терминала.

--norc

-f

Не читать ни один из системных или пользовательских файлов инициализации при запуске. Это эквивалентно использованию обоих параметров --no-init-file и --no-site-file.

--path path

-p path

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

--persist

Перейти в интерактивный режим после --eval или чтения из файла, указанного в командной строке.

--silent

--quiet

-q

Не выводить обычное приветствие и сообщение о версии при запуске.

--texi-macros-file filename

Указывает имя файла, содержащего макросы Texinfo для использования makeinfo.

--traditional

--braindead

Для совместимости с MATLAB установить начальные значения для пользовательских настроек следующим образом:

PS1                             = ">> "
PS2                             = ""
beep_on_error                   = true
confirm_recursive_rmdir         = false
crash_dumps_octave_core         = false
disable_diagonal_matrix         = true
disable_permutation_matrix      = true
disable_range                   = true
fixed_point_format              = true
history_timestamp_format_string = "%%-- %D %I:%M %p --%%"
print_empty_dimensions          = false
save_default_options            = "-mat-binary"
struct_levels_to_print          = 0

и отключить следующие предупреждения:

Octave:abbreviated-property-match
Octave:data-file-in-path
Octave:function-name-clash
Octave:possible-matlab-short-circuit-operator

Обратите внимание, что это не включает предупреждение Octave:language-extension, которое может потребоваться, если вы хотите получить информацию о написании кода, работающего в Octave, но не в MATLAB (см. warning, warning_ids).

--verbose

-V

Включить подробную информацию.

--version

-v

Вывести номер версии программы и выйти.

file

Выполнить команды из file. Выйти после завершения, если не указан также --persist.

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

argv ()

Возвращает аргументы командной строки, переданные в Octave.

Например, если вы вызвали Octave с помощью команды

octave --no-line-editing --silent

argv вернет массив ячеек строк с элементами --no-line-editing и --silent.

Если вы пишете исполняемый скрипт Octave, argv вернет список аргументов, переданных скрипту. См. Исполнимые программы Octave для примера создания исполняемого скрипта Octave.

program_name ()

Возвращает последнюю часть значения, возвращаемого program_invocation_name.

См. также: program_invocation_name.

program_invocation_name ()

Возвращает имя, введённое в командной строке оболочки для запуска Octave.

Если выполняется скрипт из командной строки (например, octave foo.m) или используется исполняемый скрипт Octave, имя программы устанавливается в имя скрипта. См. Исполнимые программы Octave для примера создания исполняемого скрипта Octave.

См. также: program_name.

Вот пример использования этих функций для воспроизведения командной строки, которая вызвала Octave.

printf ("%s", program_name ());
arg_list = argv ();
for i = 1:nargin
  printf (" %s", arg_list{i});
endfor
printf ("\n");

См. Индексирование массивов ячеек для объяснения того, как извлекать объекты из массивов ячеек, и Определения функций для информации о переменной nargin.