Penlight

• Index

Contents

• Functions

Modules

• pl
• pl.Date
• pl.List
• pl.Map
• pl.MultiMap
• pl.OrderedMap
• pl.Set
• pl.app
• pl.array2d
• pl.class
• pl.comprehension
• pl.config
• pl.data
• pl.dir
• pl.file
• pl.func
• pl.input
• pl.lapp
• pl.lexer
• pl.luabalanced
• pl.operator
• pl.path
• pl.permute
• pl.pretty
• pl.seq
• pl.sip
• pl.strict
• pl.stringio
• pl.stringx
• pl.tablex
• pl.template
• pl.test
• pl.text
• pl.utils
• pl.xml

Topics

• 01-introduction.md
• 02-arrays.md
• 03-strings.md
• 04-paths.md
• 05-dates.md
• 06-data.md
• 07-functional.md
• 08-additional.md
• 09-discussion.md

Examples

• seesubst.lua
• sipscan.lua
• symbols.lua
• test-cmp.lua
• test-data.lua
• test-listcallbacks.lua
• test-pretty.lua
• test-symbols.lua
• testapp.lua
• testclone.lua
• testconfig.lua
• testglobal.lua
• testinputfields.lua
• testinputfields2.lua
• testxml.lua
• which.lua

Module pl.sip

Simple Input Patterns (SIP).

SIP patterns start with ‘$’, then a one-letter type, and then an optional variable in curly braces.

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

‘'Type names’'

v    identifier
i     integer
f     floating-point
q    quoted string
([{<  match up to closing bracket

See the Guide

Functions

create_pattern (spec, options)	convert a SIP pattern into the equivalent Lua string pattern.
compile (spec, options)	convert a SIP pattern into a matching function.
match (spec, line, res, options)	match a SIP pattern against a string.
match_at_start (spec, line, res)	match a SIP pattern against the start of a string.
fields (spec, f)	given a pattern and a file object, return an iterator over the results
pattern (spec, fun)	register a match which will be used in the read function.
read (f)	enter a loop which applies all registered matches to the input file.

Functions

create_pattern (spec, options)

convert a SIP pattern into the equivalent Lua string pattern.

Parameters:

• spec: a SIP pattern
• options: a table; only the at_start field is currently meaningful and esures that the pattern is anchored at the start of the string.

Returns:

a Lua string pattern.

compile (spec, options)

convert a SIP pattern into a matching function. The returned function takes two arguments, the line and an empty table. If the line matched the pattern, then this function return true and the table is filled with field-value pairs.

Parameters:

• spec: a SIP pattern
• options: optional table; {anywhere=true} will stop pattern anchoring at start

Returns:

a function if successful, or nil,

match (spec, line, res, options)

match a SIP pattern against a string.

Parameters:

• spec: a SIP pattern
• line: a string
• res: a table to receive values
• options: (optional) option table

Returns:

true or false

match_at_start (spec, line, res)

match a SIP pattern against the start of a string.

Parameters:

• spec: a SIP pattern
• line: a string
• res: a table to receive values

Returns:

true or false

fields (spec, f)

given a pattern and a file object, return an iterator over the results

Parameters:

• spec: a SIP pattern
• f: a file – use standard input if not specified.

pattern (spec, fun)

register a match which will be used in the read function.

Parameters:

• spec: a SIP pattern
• fun: a function to be called with the results of the match

see also:

read

read (f)

enter a loop which applies all registered matches to the input file.

Parameters:

• f: a file object; if nil, then io.stdin is assumed.