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 (см. warning, warning_ids).

--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 см. в разделе Определение функций.