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.

   strict
       This method returns true or false based on the value of the 'strict' argument to "new()".

SUPPORT

       Support is by the author. Please file bug reports at
       <https://rt.cpan.org/Public/Dist/Display.html?Name=PPIx-Regexp>,
       <https://github.com/trwyant/perl-PPIx-Regexp/issues>, or in electronic mail to the author.

AUTHOR

       Thomas R. Wyant, III wyant at cpan dot org

COPYRIGHT AND LICENSE

       Copyright (C) 2009-2023 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.