GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  PARSE::YYLEX (3)

.ds Aq ’

NAME

"Parse::YYLex" - Version of Parse::Lex to be used by a byacc parser.

CONTENTS

SYNOPSIS

Parse::Lex requires this perl version:
require 5.004;
use Parse::YYLex;

If using a procedural parser:
Parse::YYLex->create ...; # exports &yylex and $yylval
# see Parse::Lex for the token table args <...>
Parse::YYLex::lex->from(\*FH);
require ’MyParser.pl’; # generated by byacc
yyparse();

If using an object-oriented parser:
$lexer = new Parse::YYLex ...;
# see Parse::Lex for the token table args <...>
use MyParser; # generated by byacc5
$parser = new MyParser($lexer->getyylex, \&yyerror, $debug);
# you must write &yyerror
$lexer->from(\*STREAM);
$parser->yyparse(*STREAM);

To get the token definitions from MyParser.ph instead of y.tab.ph or to change the skip regexp (default whitespace), do this before calling new or create:
Parse::YYLex->ytab(’MyParser.ph’);
Parse::YYLex->skip(’’);

DESCRIPTION

Often times you’d use a lexer in conjunction with a parser. And most of the time you’d want to generate that parser with a yacc parser generator. <B>Parse::YYLexB> is a derivative of Parse::Lex compatible with yacc parsers, by adapting it to the byacc calling conventions:
o The parser wants to receive integer token types as defined in y.tab.ph instead of the symbolic types that Parse::Lex returns.
o The parser wants its tokens as two components (type and value), whereas Parse::Lex returns one object with these two components. Furthermore, a procedural parser wants the value stored in a variable $yylval.
o The parser wants to receive the tokens by calling a yylex <B>functionB>, not an object <B>methodB>. Thus we have to give the parser a curried form of the lexer function, where the self argument is fixed.

    Procedural Parsers

Yacc (and Bison) traditionally generate C or C++ parsers. Fortunately, Berkeley yacc has been modified to generate Perl, see
ftp://ftp.sterling.com/local/perl-byacc.tar.Z

Byacc with the -P option generates procedural perl code that is compatible with both perl4 and perl5. (However you cannot use <B>Parse::YYLexB> with perl4.) Use this variant for quick hacks, as it is more convenient than the one below. In this case Parse::YYLex-create> instantiates a lexer and exports a &yylex function (the lexer) and a $yylval variable (the token value) to its caller’s namespace (which should be the namespace of the parser).

If you need to call any object methods of the created lexer (see Parse::Lex for documentation), use the $Parse::YYLex::lex variable.

    Object-Oriented Parsers

Another byacc modification (I call it byacc5) generates object-oriented Perl5 code:
CPAN/authors/id/JAKE/perl5-byacc-patches-0.5.tar.gz

Use this variant if you need more than one parser, you need flexibility, or you simply like OO. In this case you need to use new, and pass the return value of getyylex (a reference to the curried lexing function) to the parser. The lexing function returns a two-element array, the token type and value.

    Numeric Token Table

Yacc parsers insist on using numeric token types, and define these in a file customarily named y.tab.ph. That is where <B>Parse::YYLexB> will look by default, and the file has to be in the @INC path (which includes the current directory).

You can specify a different token table before calling new or create:
Parse::YYLex->ytab(’MyParser.ph’);

LIMITATIONS

Parse::YYLex is based on Parse::Lex which requires perl 5.004 and will not work with earlier versions. A slightly different version, Parse::CLex, works with earlier perl versions. It would be easy to allow a choice between Parse::Lex and Parse::CLex, but the latter has some limitations, and presently seems to have some bugs.

AUTHOR

Vladimir Alexiev <vladimir@cs.ualberta.ca>

SEE ALSO

byacc(1), Parse::Lex.
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 PARSE::YYLEX (3) 2011-12-31

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.