Previous TOC Next | Parsers/SimpleCalcYYLexer.pm | Code | PDF | PDFGreen | PDFA4 | PDFA4Green

# NAME

Parsers::SimpleCalcYYLexer

# SYNOPSIS

use Parsers::SimpleCalcYYLexer;

use Parsers::SimpleCalcYYLexer qw(:all);

# DESCRIPTION

SimpleCalcYYLexer class provides the following methods:

new, YYLex, GetYYLex, StringifySimpleCalcYYLexer

Parser::SimpleCalcYYLexer class is derived from Parser::YYLexer class, which in turn is derived from base class Parser::Lexer that provides all the underlying lexer functionality. SimpleCalcYYLexer class is designed to be used with yyparse code generated by running byacc on a parser defined using parser definition SimpleCalcParser.yy file.

The parser package and token table files, SimpleCalcParser.pm and SimpleCalcParser.tab.ph, are automatically generated from parser grammar definition file, SimpleCalcParser.yy, using byacc available through perl-byacc1.8 modified with perl5-byacc-patches-0.5 for generation of object oriented parser:

byacc -l -P -d -b SimpleCalcParser SimpleCalcParser.yy
mv SimpleCalcParser.tab.pl SimpleCalcParser.pm

SimpleCalcYYLexer.pm class implements a lexer for a simple calculator and is provided to highlight usasge of YYLex through yyparse.

The default specification of lexer tokens for SimpleCalcYYLexer.pm includes:

@YYLexerTokensSpec = (
[ 'LETTER', qr/[a-zA-Z]/ ],
[ 'NUMBER', qr/\d+/ ],
[ 'SPACE', qr/[ ]*/,
sub { my($This, $TokenLabel, $MatchedText) = @_; return ''; }
],
[ 'NEWLINE', qr/(?:\r\n|\r|\n)/,
sub { my($This, $TokenLabel, $MatchedText) = @_; return "\n"; }
],
[ 'CHAR', qr/./ ]
);

The default SimpleCalcParser.tab.ph file containing token identifiers for SimpleCalcParser.yy includes:

$NUMBER=257;
$LETTER=258;

## METHODS

new
  $SimpleCalcYYLexer = new Parsers::SimpleCalcYYLexer($Input);

  Using specified Input, new method generates a new SimpleCalcYYLexer and returns a reference to newly created SimpleCalcYYLexer object.

  Examples:

  # Input string...
  $InputText = "3 + 4 +6\nx=3\ny=5\nx+y\nx+z\n";
  $YYLexer = new Parsers::SimpleCalcYYLexer($InputText);
  $YYLex = $YYLexer->GetYYLex();
  $Debug = 0;
  $CalcParser = new Parsers::SimpleCalcParser($YYLex,
  \&Parsers::SimpleCalcParser::yyerror, $Debug);
  $Value = $SimpleCalcParser->yyparse();
  print "Value: $Value\n";
  # Input file...
  $InputFile = "Input.txt";
  open INPUTFILE, "$InputFile" or die "Couldn't open $InputFile: $!\n";
  $YYLexer = new Parsers::SimpleCalcYYLexer($InputFile);
  $YYLex = $YYLexer->GetYYLex();
  $CalcParser = new Parsers::SimpleCalcParser($YYLex,
  \&Parsers::SimpleCalcParser::yyerror);
  $Value = $SimpleCalcParser->yyparse();
  print "Value: $Value\n";
  # Input file iterator...
  $InputFile = "TestSimpleCalcParser.txt";
  open INPUTFILE, "$InputFile" or die "Couldn't open $InputFile: $!\n";
  $InputIterator = sub { return <INPUTFILE>; };
  $YYLexer = new Parsers::SimpleCalcYYLexer($InputIterator);
  $YYLex = $YYLexer->GetYYLex();
  $CalcParser = new Parsers::SimpleCalcParser($YYLex,
  \&Parsers::SimpleCalcParser::yyerror);
  $Value = $SimpleCalcParser->yyparse();
  print "Value: $Value\n";
StringifySimpleCalcYYLexer
  $YYLexerString = $YYLexer->StringifySimpleCalcYYLexer();

  Returns a string containing information about YYLexer object.

# AUTHOR

Manish Sud

# SEE ALSO

Lexer.pm, YYLexer.pm, SimpleCalcParser.yy

# COPYRIGHT

Copyright (C) 2018 Manish Sud. All rights reserved.

This file is part of MayaChemTools.

MayaChemTools is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.

Previous TOC Next | October 25, 2018 | Parsers/SimpleCalcYYLexer.pm