命令行标志

大多数 Linux(以及部分 Windows)程序都接受命令行标志。用短横线标记命令行标志是通行做法。Linux 的 ls 目录列表程序就是一个例子:-l 标志告诉 ls 打印当前目录中文件的扩展列表。

ls -l

Modeler 同样遵循短横线约定。程序接受的每个偏好设置都可以通过以短横线开头的命令行标志来赋值。下面给出了一个程序调用示例。

op_vuorb -orb_name leo -sm_axis 6700.0 -moon_effects

大多数偏好设置需要一个取值参数:在上面的示例中,sm_axis 偏好设置被赋值为 6700.0,orb_name 偏好设置被赋值为 "leo"。而布尔型偏好设置 moon_effects 不需要取值参数,只要在命令行中包含它,就等同于将其值设为 TRUE。

下表列出了四种基本偏好设置类型的命令行语法。

表 10:基本偏好设置类型的命令行语法

类型 语法 示例
integer -><attr_name> <int_value> -size 345
double -><attr_name> <double_value> -mean_anomaly 214.6
string -><attr_name> <string_value> -orb_name statkeep
-site_name "QTH"
boolean -><attr_name>
-><attr_name> <boolean_value>
-verbose
-verbose OFF

其中 <boolean_value> 定义为以下字符串之一:

  • on/off
  • true/false
  • enabled/disabled

(<boolean_value> 字符串允许大小写字母的任意组合——例如 ON、True、ENabled 等。)

以下是作为命令行标志使用的偏好设置的语法注意事项。

  • 单个单词的字符串(不含嵌入的空格或制表符)可以直接跟在标志名之后。由多个单词组成的字符串必须用双引号括起来。
  • 包含短横线的字母数字字符串(例如要传递给另一个程序的标志)必须采用以下方式之一指定:
    • 将取值用双引号括起来,并在短横线前加一个空格。例如:-bind_flags " -g"
    • 将短横线改为脱字符(会自动转换回连字符)。例如:-bind_flags ^g
  • 以短横线开头的数字字符串始终被解释为负数,可以直接跟在标志名之后。
  • 布尔型标志有两种形式:
    • 简短形式:不提供取值参数(默认取值为 TRUE)。
    • 完整形式:提供 boolean 取值参数。
  • 列表型偏好设置使用基本偏好设置语法的扩展。每个偏好设置名标志之后可以有多个取值,而不是单个取值。下面给出了通过命令行赋值字符串列表偏好设置的示例。在该示例中,ef 偏好设置被赋值为两个字符串:base_orb_defs and low_earth_defs.
	op_vuorb -ef base_orb_defs low_earth_defs

命令行标志机制适用于随每次运行而变化的偏好设置(例如 verbose 偏好设置),但不太适合传递大量偏好设置。对于需要传递大量偏好设置的程序,通过环境文件机制传递大部分偏好设置更为高效。