命令行参数(GNU Octave(版本10.1.0))

下一个启动文件上级从命令行调用Octave[目录][索引]

2.1.1命令行参数¶

以下是Octave接受的命令行参数的完整列表。

--built-in-docstrings-file filename ¶: 指定包含Octave内置函数的文档字符串的文件名。此值通常是对的,只需在特殊情况下指定。

--doc-cache-file filename ¶

指定要使用的文档缓存文件的名称。在命令行上指定的filename的值将覆盖OCTAVE_DOC_CACHE_FILE环境变量中的值，但在系统或用户启动文件中的值不受doc_cache_file影响。

--echo-commands ¶

-x

执行命令时回显命令。

--eval code ¶

-e code

在运行代码code完成后退出,除非--persist也被指定。

--exec-path path ¶

指定搜索要运行的程序的路径。在命令行上指定的path的值将覆盖OCTAVE_EXEC_PATH环境变量中的值，但在系统或用户启动文件中的值不受EXEC_PATH影响。

--gui ¶

-g

启动图形用户界面(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影响。

--init-trace ¶

打印每个配置的名称，就像在初始化时读取并执行的那样。

--interactive ¶

-i

强制交互行为。这对于通过远程shell命令或在Emacs shell缓冲区内运行Octave非常有用。

--line-editing ¶

强制readline用于命令行编辑。

--no-gui ¶

-G

禁用图形用户界面(GUI),改为使用命令行界面(CLI)。这是默认行为,但此参数可能有助于覆盖前一个--gui.

--no-history ¶

-H

禁止记录命令行历史记录。

--no-init-all ¶

--norc

-f

禁止在启动时读取任何系统或用户初始化文件。这等效于同时使用--no-site-file 和--no-init-user选项。

--no-init-path ¶

不要将函数文件的搜索路径初始化为包含默认位置。

--no-init-site ¶

不要在整个网站上读取初始化文件octaverc。

--no-init-user ¶

不要读取用户初始化文件~/.octaverc和 .octaverc。

--no-line-editing ¶

禁用命令行编辑。

--no-window-system ¶

-W

禁止使用包括图形在内的窗口系统。这将严格限制终端环境。

--path path ¶

-p path

将路径添加到函数文件的搜索路径的开头。在命令行上指定的path的值将覆盖OCTAVE_PATH环境变量中的值，这不包含在系统或用户启动文件中设置的内部加载路径的所有命令。

--persist ¶

在--eval之后转到交互模式，或者从命令行上命名的文件中读取。

--quiet ¶

--silent

-q

启动时不要打印通常的问候语和版本信息。

--texi-macros-file filename ¶

指定包含供makeinfo使用的Texinfo宏的文件的名称。

--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_ids.

--version ¶

-v

打印程序版本号并退出。

file

从执行命令file.完成后退出,除非--persist也是指定的。

Octave还包括几个函数,这些函数返回有关命令行的信息,包括参数的数量和所有参数。

: args = argv () ¶

返回传递给Octave的命令行参数。

例如,如果使用命令调用Octave

octave --no-line-editing --quiet

argv将返回包含元素的字符串的元胞数组--no-line-editing和--quiet.

如果您编写一个可执行的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 () ¶

返回在shell提示符下输入的字符串以运行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的信息.

下一个启动文件上级从命令行调用Octave[目录][索引]