MicroStationCONNECT Edition 帮助

流指令和变量指令

流指令控制本产品处理配置文件的方式。流指令始终以 % 开头。以下流指令可用:

流指令 语法 含义
%include %include<filespec> 在继续此配置文件中的下一行之前,需先包括一个或多个配置文件。<filespec> 可以指定单个文件,也可以包括通配符以包含多个文件。<filespec> 可以包含配置变量例如:

%include $(_USTN_WORKSPACECFG)

%include<filespec> level <levelspec> The %include 指令可以包括所含文件中的赋值应用到(直至遇到其他级别的指令)的配置变量级别。例如:

%include $(_USTN_ROLECFG) level Role

%if %if <expression> 如果 <expression> 的计算结果为 true,则继续下一行,否则跳到匹配的 %else%elif%endif 语句。有关 <expression> 的语法,请参阅运算符。例如:

%if $(PHASE)=="Final"

%ifdef %ifdef<cfgvar> 如果定义了 <cfgvar>,则继续下一行,否则跳到匹配的 %else%elif%endif 语句。例如:

%ifdef _USTN_ROLECFG

%ifndef %ifndef<cfgvar> 如果未定义 <cfgvar>,则继续下一行,否则跳到匹配的 %else%elif%endif 语句。例如:

%ifndef MS_DEF

%else %else 计算结果为 false 的 %if%ifdef%ifndef 语句将在匹配的 %else 语句(如有)后面的行继续执行。
%elif %elif <expression> 计算结果为 false 的 %if%ifdef%ifndef 语句通过在第一个匹配的 %elif 语句对 <expression> 进行求值来继续执行操作,然后继续处理下面的行(如果表达式的计算结果为 true),或者跳到下一个 %elif%else%endif 语句。例如:

%elif defined (MS_RFDIR)

%endif %endif 该语句指示 %if%ifdef%ifndef 语句的条件块的结尾。
%echo %echo<message> MicroStation 文本窗口中显示 <message> 的内容并继续处理。例如:

%echo $(MS_DEF)

%error %error<message> 导致处理停止,将 <message> 的内容报告为错误。例如:

%error unexpected value

变量指令

支持以下变量指令:

变量指令 语法 定义
%lock %lock<cfgvar> 锁定 配置变量<cfgvar>,使其无法更改。
%undef %undef<cfgvar> 放弃配置变量的值并将其设置为未定义。
%level %level<newLevel> 指定要应用以下任何配置变量定义的级别。<newlevel> 参数应为以下选项之一:
  • 系统
  • 应用程序
  • 单位
  • 工作空间
  • 工作集
  • 角色
  • 用户
注释: 上述参数区分大小写。