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

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

--built-in-docstrings-file filename ¶

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

--debug ¶

-d

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

--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 ¶

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

--info-program program ¶

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

--interactive ¶

-i

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

--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
optimize_diagonal_matrix        = false
optimize_permutation_matrix     = false
optimize_range                  = false
fixed_point_format              = true
history_timestamp_format_string = "%%-- %D %I:%M %p --%%"
print_empty_dimensions          = false
print_struct_array_contents     = true
save_default_options            = "-mat-binary"
struct_levels_to_print          = 0

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

Octave:abbreviated-property-match
Octave:colon-nonscalar-argument
Octave:data-file-in-path
Octave:empty-index
Octave:function-name-clash
Octave:possible-matlab-short-circuit-operator

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

--verbose ¶

-V

Включить подробный вывод.

--version ¶

-v

Вывести номер версии программы и завершить работу.

file

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

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

: args = argv () ¶

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

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

octave --no-line-editing --silent

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

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

См. также: program_name, cmdline_options.

: opt_struct = cmdline_options () ¶

Возвращает структуру, содержащую подробную информацию об аргументах командной строки, переданных Octave.

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

См. также: argv, program_name.

: name = program_name () ¶

Возвращает имя файла, полученное из значения, возвращаемого program_invocation_name.

См. также: program_invocation_name, argv.

: name = program_invocation_name () ¶

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

Строка может включать пути и имя файла программы.

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

См. также: program_name, argv.

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

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

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