MS-DOS 批处理命令

Opus 按钮或热键功能可以设置为 MS-DOS 批处理功能 模式。此模式中的一个功能的运行方式就像 .bat 批处理文件一样，它可以使用 MS-DOS 命令、分支和逻辑指令，还可以运行仅设计为从命令行运行的外部程序。您还可以在批处理功能中包含常规 Opus 内部命令（请注意，当尝试使用 Set 或 Copy 等与内部命令冲突的外部命令时，可能会造成混乱 - 使用下面描述的 @externalonly 修饰符解决此问题）。

上面的屏幕截图演示了一个简单的 MS-DOS 批处理功能示例。它使用 MS-DOS dir 指令生成当前源文件夹的目录列表。使用 > 重定向符号，目录列表将保存到目标路径中，文件名以当前源文件夹命名。

分解该功能：

• 使用 Function 下拉菜单将类型设置为 MS-DOS Batch Function。这对于使用 dir 指令是必要的 - dir 不是一个真正的程序或命令，它是一个仅由 MS-DOS 命令解释器理解的指令。

• 命令的第一行 cd {sourcepath} 将批处理脚本的当前目录设置为当前源文件夹。这是 dir 将生成其列表的文件夹。

• 第二个命令调用 dir 指令（** /w** 标志打开“宽”模式）。> 字符会重定向该命令的输出，在 > 后面，外部控制代码的组合会提供输出文件名。

  • {destpath} - 当前目标目录的路径

  • {sourcepath|nopath|noterm} - 当前源目录，不含路径或尾随终止符（即目录的名称）

  • .txt - 输出文件的扩展名。

当您运行 MS-DOS 批处理功能时，Opus 实际上会创建磁盘上的一个临时批处理文件，并在调用它之前将指令写入其中。如果您查看由上述功能创建的批处理文件，您将看到类似以下内容：

@echo off
chcp 1252 > nul
C:
cd "\Users\Jon\Documents"
dir /w > "C:\Test\Documents.txt"

这些指令会根据该功能的参数和定义自动写入到 .bat 文件。

• @echo off 是一个标准的 MS-DOS 指令，它可以防止在批处理文件运行时将每个命令都回显到提示窗口

• chcp 1252 > nul 初始化命令提示符的代码页（1252 是标准的 Windows 代码页）。

• C: 设置命令提示符的当前驱动器 - 这是从命令定义中的 cd {sourcepath} 指令自动生成的。

• cd "\Users\Jon\Documents" 设置当前驱动器上的当前目录 - 同样，这是从 cd {sourcepath} 指令自动生成的。

• dir /w > "C:\Test\Documents.txt" 负责生成实际的目录列表。在这个示例中，源文件夹名为 Documents，目标文件夹为 C:\Test* - 所以由 {destpath}{sourcepath|nopath|noterm}.txt 生成的输出文件名为 C:\Test\Documents.txt。

命令修饰符 中有几个与 MS-DOS 批处理功能特别相关：

• @leavedoswindowopen 可用于强制 DOS 提示窗口在函数完成之后保持打开（让您看到任何输出或错误消息）。

• @codepage 可用于将 DOS 提示符的代码页更改为默认值 1252。

• @externalonly 告诉 Opus 忽略可能与内部命令重合的任何命令名称（例如 Set 或 Copy）。通常情况下，内部命令会覆盖外部命令。

• @nocall 用于调用批处理文件而不将控制权返回给父函数。

• @runbatch 和 @norunbatch 控制外部程序和内部命令如何在 MS-DOS 批处理功能中进行交互

• @runmode:hide 可用于防止 DOS 提示窗口短暂闪烁。

有关命令修饰符的完整描述，请参见 命令修饰符参考。