lua工具库penlight--08额外的库（一）

额外的库

在这一节中的库不再被认为是Penlight的核心部分，但在需要时，仍提供专门的功能。

简单的输入的模式

Lua 的字符串模式匹配是非常强大，通常您将不需要传统的正则表达式库。即便如此，有时 Lua 代码结束看上去像 Perl，因为字符串模式不容易阅读，尤其是对普通读者而言。这段代码需要了解三种不同的日期格式：

-- parsing dates using Lua string patterns

months={Jan=1,Feb=2,Mar=3,Apr=4,May=5,Jun=6,

Jul=7,Aug=8,Sep=9,Oct=10,Nov=11,Dec=12}

function check_and_process(d,m,y)

d = tonumber(d)

m = tonumber(m)

y = tonumber(y)

....

end

for line in f:lines() do

-- ordinary (English) date format

local d,m,y = line:match('(%d+)/(%d+)/(%d+)')

if d then

check_and_process(d,m,y)

else -- ISO date??

y,m,d = line:match('(%d+)%-(%d+)%-(%d+)')

if y then

check_and_process(d,m,y)

else -- <day> <month-name> <year>?

d,mm,y = line:match('%(d+)%s+(%a+)%s+(%d+)')

m = months[mm]

check_and_process(d,m,y)

end

这些不是特别困难的模式，但典型问题已经出现，例如，不得不转义 ' — '。此外， string.match返回其捕获，这样，我们被迫使用略显尴尬的嵌套的 if 语句。

验证码检验问题，使用正则表达式的人试图强制约束（如一年不能超过四位数）。我们应该享受匹配，而不是拿着锤子砸自己。

pl.sip提供了简单、直观的方式来检测字符串中的模式和提取的相关部分。

> sip = require 'pl.sip'

> dump = require('pl.pretty').dump

> res = {}

> c = sip.compile 'ref=$S{file}:$d{line}'

> = c('ref=hello.c:10',res)

true

> dump(res)

{

line = 10,

file = "hello.c"

}

> = c('ref=long name, no line',res)

false

sip.compile可以从给定字符串和表创建一个模式匹配器函数。如果匹配字符串，则返回true ，根据模式中命名字段填充该表。

这里是另一个版本的日期分析器：

-- using SIP patterns

function check(t)

check_and_process(t.day,t.month,t.year)

end

shortdate = sip.compile('$d{day}/$d{month}/$d{year}')

longdate = sip.compile('$d{day} $v{mon} $d{year}')

isodate = sip.compile('$d{year}-$d{month}-$d{day}')

for line in f:lines() do

local res = {}

if shortdate(str,res) then

check(res)

elseif isodate(str,res) then

check(res)

elseif longdate(str,res) then

res.month = months[res.mon]

check(res)

end

SIP 模式以'$'开始，之后跟着单字母类型，后面大括号中的是可选变量。

Type Meaning

v variable, or identifier.

i possibly signed integer

f floating-point number

r 'rest of line'

q quoted string (either ' or ")

p a path name

( anything inside (...)

[ anything inside [...]

{ anything inside {...}

< anything inside <...>

[---------------------------------]

S non-space

d digits

...

如果类型不是 v、 i、 f、 r 或 q 之一，它被假定为标准 Lua 字符。你在模式中的任何空格将匹配任意数目的空格。'神奇' 字符串中的任何字符均被转义。

SIP 捕获（像$v{mon}) 不需要进行命名。您可以使用只是$v，但你必须保持一致；如果一种模式包含未命名的捕获，然后所有捕获必须都是未命名。在这种情况下，结果表是一个简单的值列表。

sip.match是有用的快捷方式，如果你喜欢你 '占位' 。（它将缓存结果，所以它比显式用sip.compile快些.)

> sip.match('($q{first},$q{second})','("john","smith")',res)

true

> res

{second='smith',first='john'}

> res = {}

> sip.match('($q,$q)','("jan","smit")',res) -- unnamed captures

true

> res

{'jan','smit'}

> sip.match('($q,$q)','("jan", "smit")',res)

false ---> oops! Can't handle extra space!

> sip.match('( $q , $q )','("jan", "smit")',res)

true

作为一般规则，允许您模式中的空白。

最后，放在模式的结尾的 '$' 意味着 '捕获的在第一个非空格开头的行。

> sip.match('( $q , $q ) $','("jan", "smit") and a string',res)

true

> res

{'jan','smit','and a string'}

> res = {}

> sip.match('( $q{first} , $q{last} ) $','("jan", "smit") and a string',res)

true

> res

{first='jan',rest='and a string',last='smit'}

命令行程序与 Lapp

pl.lapp是小而专注的Lua 模块，它的目的是要使标准命令行解析更方便和直观。它实现了 GNU 风格，即以短横线'-'或长横线' --'开始的字母。一般带参数的选项期望找到下一个输入作为它的参数（例如 ' gcc test.c -o test'），单个短选项可以忽略空格 (例如 'head -n4 test.c' 或gcc -I/usr/include/lua/5.1 …)

Lapp 尽其可能将参数转换为等效的 Lua 类型，即转换数字、文件名转换为文件对象。如果任何转换失败，或缺少所需的参数，则将发出错误消息、并用文本输出。所以有两个必要的任务，提供的标志和选项的名字，并将它们和类型关联。

对于任何非平凡的脚本，或仅为了个人消遣，有必要提供使用说明。Lapp 的新颖性是定义了松散格式的字符串用法，而且可以指定参数的名称和类型。

示例：

-- scale.lua

lapp = require 'pl.lapp'

local args = lapp [[

Does some calculations

-o,--offset (default 0.0) Offset to add to scaled number

-s,--scale (number) Scaling factor

<number> (number ) Number to be scaled

]]

print(args.offset + args.scale * args.number)

这里是在命令行的会话中使用此脚本：

$ lua scale.lua

scale.lua:missing required parameter: scale

Does some calculations

-o,--offset (default 0.0) Offset to add to scaled number

-s,--scale (number) Scaling factor

<number> (number ) Number to be scaled

$ lua scale.lua -s 2.2 10

$ lua scale.lua -s 2.2 x10

scale.lua:unable to convert to number: x10

....(usage as before)

有两种类型的 Lapp 用法让字符串更有意义。短选项，可以选择其相应的长选项。可遵循括号中的类型说明符。同样，以 '<' PARMETER ' >' 开头的参数行，后面跟着的是类型说明符。类型说明符是任一形式'(默认是 'VALUE')' 或 '(' TYPE')' ；默认的说明符意味着选项或参数有默认值，并不是必需的。类型是一个 '字符串'、 '数'、 '文件输入' 或 '文件输出' ；VALUE是一个数字，（'stdin'、 'stdout'、 'stderr') 之一或者是标记。这行的其余不会被分析，可以用作注释。

此脚本在输出表中显示的字段与指定的参数名称之间的关系。

-- simple.lua

local args = require ('pl.lapp') [[

Various flags and option types

-p A simple optional flag, defaults to false

-q,--quiet A simple flag with long name

-o (string) A required option with argument

<input> (default stdin) Optional input file parameter

]]

for k,v in pairs(args) do

print(k,v)

end

上面显示了args表的所有参数；请注意，args.quiet 已经成为为 true，因为它被指定；args.p 默认为 false。如果有一个长命名选项，它将在选项中用作局部名称。因为默认的类型是布尔类型，对于简单的标志，它的类型或默认值不是必须的。

$ simple -o test -q simple.lua

p false

input file (781C1BD8)

quiet true

o test

input_name simple.lua

D:\dev\lua\lapp>simple -o test simple.lua one two three

1 one

2 two

3 three

p false

quiet false

input file (781C1BD8)

o test

input_name simple.lua

参数输入已设置为打开的只读文件对象 — — 我们知道它必须是一个只读的文件，因为它是默认值的类型。input_name字段会自动生成，因为它经常用来访问原始文件名。

请注意，提供的任意额外参数会放到整数索引表里，即 args [i] ，i表示1 到 #args 之间的值。

对有良好定义和明确任务的短脚本，文件真的不必显式关闭，因为垃圾收集文件对象的结果就是关闭它们。

巴特西

lua工具库penlight--08额外的库（一）

最新文章

热门文章