NAME¶
PPIx::Regexp::Lexer - Assemble tokenizer output.
SYNOPSIS¶
use PPIx::Regexp::Lexer;
use PPIx::Regexp::Dumper;
my $lex = PPIx::Regexp::Lexer->new('qr{foo}smx');
my $dmp = PPIx::Regexp::Dumper->new( $lex );
$dmp->print();
INHERITANCE¶
"PPIx::Regexp::Lexer" is a PPIx::Regexp::Support.
"PPIx::Regexp::Lexer" has no descendants.
DESCRIPTION¶
This class takes the token stream generated by PPIx::Regexp::Tokenizer and
generates the parse tree.
METHODS¶
This class provides the following public methods. Methods not documented here
are private, and unsupported in the sense that the author reserves the right
to change or remove them without notice.
new¶
This method instantiates the lexer. It takes as its argument either a
PPIx::Regexp::Tokenizer or the text to be parsed. In the latter case the
tokenizer is instantiated from the text.
Any optional name/value pairs after the first argument are passed to the
tokenizer, which interprets them or not as the case may be.
errstr¶
This method returns the error string from the last attempt to instantiate a
"PPIx::Regexp::Lexer". If the last attempt succeeded, the error will
be "undef".
failures¶
print $lexer->failures(), " parse failures\n";
This method returns the number of parse failures encountered. A parse failure is
either a tokenization failure (see PPIx::Regexp::Tokenizer->
failures()) or a structural error.
lex¶
This method lexes the tokens in the text, and returns the lexed list of
elements.
SUPPORT¶
Support is by the author. Please file bug reports at <
http://rt.cpan.org>,
or in electronic mail to the author.
AUTHOR¶
Thomas R. Wyant, III
wyant at cpan dot org
COPYRIGHT AND LICENSE¶
Copyright (C) 2009-2014 by Thomas R. Wyant, III
This program is free software; you can redistribute it and/or modify it under
the same terms as Perl 5.10.0. For more details, see the full text of the
licenses in the directory LICENSES.
This program is distributed in the hope that it will be useful, but without any
warranty; without even the implied warranty of merchantability or fitness for
a particular purpose.