string.cmdline 库模块帮助文档

一、_ARGV 或 string.cmdline.argv 解析命名参数的语法规则

以斜杠或短横线开始的前导参数作为键。 自动移除一个或多个相同的前导字符作为键名。

如果前导参数包含等号，则以等号拆分为键值对，等号前后不应有空格, 否则检查下一参数如果没有相同的首字符则设为此键对应的值。 如果一个前导参数没有指定值，则默认值为空字符串（逻辑值为true）。

1、参数名区分大小写 2、以斜杠或短横线开始的前导参数作为键名(键名移除一个或多个相同的前导字符,区分大小写)， 如果前导参数包含等号，则以等号拆分为键值对，等号前后不应有空格, 否则检查下一参数如果没有相同的首字符则设为此键名对应的值， 如果一个前导参数没有指定值，则默认值为空字符串（逻辑值为 true）。

也就是说以下写法对于 string.cmdline.argv 或 _ARGV 是等价的

--name=value --name value -name value /name value

注意多次指定同名参数，则仅保存最后一次设定的值。 所有命名参数、非命名参数都会添加到解析返回参数表的数组成员中。

二、string.cmdline.argv2 解析命名参数的语法规则

除支持 string.cmdline.argv(str) 相同的功能与解析规则以外， string.cmdline.argv2(str,option) 增加以下规则：

单个 - 开头的命名参数解析为短参数。 短参数可以用空格分隔参数值，也可以省略分隔符（等号不作为分隔符）。

可在第 2 个调用参数中指定一个 @option 选项表。 @option 的所有键名用于指定待解析的命令行参数名字。 @option 预定义的单字符或多字符名字可作为短参数名、长参数名使用。 @option 预定义的单字母参数名允许作为短参数名合并到一个参数段。

@option 中参数名对应的值可以为任何非 false 值。 如果 @option 表中定义的值是函数，则每次解析对应名称参数时都会回调该函数。 回调参数 @1 为解析得到的参数值，而回调参数 @2 为将要返回的解析结果（参数表）

二、调用外部程序传命名参数的语法规则

命令行程序通常会用 / - 或 -- 作为参数名前导字符。 参数的名字与值以用空格分开。

很多程序同一个参数会提供长参数、短参数两个版本。 长参数名以 -- 开始，短参数名以 - 开始。

长参数或短参数一般都支持以空格分隔名字与值。 但长参数还可以用等号分隔其值，短参数还可以省略分隔符

例如 以 aria2 为例，以下几种写法是等价的：

aria2 -j12 其他参数 aria2 -j 12 其他参数 aria2 --max-concurrent-downloads=12 其他参数 aria2 --max-concurrent-downloads 12 其他参数 有些时候可能不支持等号分隔值，空格分隔的兼容性可能更好一些

多个短参数可以合并。 例如"-v -i" 可以写为 "-vi" 。

有时候短参数后面可以跟另外一个键值对，例如 7zip 的参数： -mmt=on