TITLE

Tcl::Glob - Parse and compile glob notation expressions.

DESCRIPTION

A parser for Tcl-stype glob notation.

Functions

compile_glob(PMC source, PMC adverbs :slurpy :named)

Return the result of compiling the glob expression given by source. Normally this function is obtained using compreg 'Tcl::Glob' instead of calling it directly.

Returns the compiled regular expression. If a target named parameter is supplied, then it will return the parse tree (target='parse'), the expression tree (target='exp'), or the resulting PIR code (target='PIR').

glob(PMC mob, PMC adverbs :slurpy :named)

Parses a glob expression, returning the corresponding parse PGE::Match object.

glob_literal(PMC mob, PMC adverbs)

Scan a literal from a string, stopping at any metacharacters such as * or [. Return the matched portion, with the result_object set to the decoded literal.

glob_quest(PMC mob, PMC adverbs)

Process a ? wildcard character in a glob. For this we just return a CCShortcut that is set to '.'

glob_star(PMC mob, PMC adverbs)

Process a * wildcard character in a glob. This is a little bit more complex, as we have to return a quantified '.'.

glob_enum(PMC mob, PMC adverbs)

Parse an enumerated character list, such as [abcd], [!abcd], and [^0-9].

glob_alt(PMC mob, PMC adverbs)

Parse an enumerated character list, such as [abcd], [!abcd], and [^0-9].

register(string name, pmc compsub)

Registers this compiler object as name and using compsub as the subroutine to call for performing compilation.

compile(pmc code [, "option" => value, ... ])

Compile source (possibly modified by any provided options).

BUGS AND LIMITATIONS

This is basically a cut and paste of PGE::Glob. There should probably be much less code duplication here.

AUTHOR

PGE::Glob was originally authored by Jonathan Scott Duff (duff@pobox.com), It has been updated for later versions of PGE by Patrick R. Michaud (pmichaud@pobox.com).