NAME

Lang::Tree::Builder::Parser - Parse Tree Definitions

SYNOPSIS

  use Lang::Tree::Builder::Parser;
  my $parser = new Lang::Tree::Builder::Parser();
  my $data = $parser->parseFile($datafile);

DESCRIPTION

A parser for class definitions. The data file input to the parse method has the following simple format:

  # a comment
  [abstract] [<parent>] <class>(<class> [<name>], ... )
  ...

for example

  # this class has no base class and is initialized with a scalar
  IntNode(scalar)
  # the list class is abstract
  abstract List()
  # this class is a type of List and takes initializers Foo::Node and Foo::List
  List Foo::List(Foo::Node first,
                 Foo::List rest)
  # this class is an abstract type of List and takes no initializers
  List EmptyList()

apart from arbitrary class names as initializers, the keyword scalar is recognized.

new

  my $parser = new Lang::Tree::Builder::Parser;

Creates and returns a new instance of a parser.

parseFile

  my $data = $parser->parseFile($datafile);

Parses $datafile and returns an instance of Lang::Tree::Builder::Data

SEE ALSO

Lang::Tree::Builder

AUTHOR

Bill Hails, <me@billhails.net>

COPYRIGHT AND LICENSE

Copyright (C) 2008 by Bill Hails

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.8 or, at your option, any later version of Perl 5 you may have available.