Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
Forest::Tree::Builder(User Contributed Perl DocumentatForest::Tree::Builder(3)

NAME
       Forest::Tree::Builder - An abstract role	for bottom up tree reader

SYNOPSIS
	   package MyBuilder;
	   use Moose;

	   with	qw(Forest::Tree::Builder);

	   # implement required	builder:

	   sub _build_subtrees {
	       return [
		   $self->create_new_subtree( ... ), # probably	a recursive process
	       ];
	   }

	   my $builder = MyBuilder->new(
	       tree_class => ...,
	       ...
	   );

	   my $tree = $builder->tree;

DESCRIPTION
       Forest::Tree::Builder replaces Forest::Tree::Loader and
       Forest::Tree::Reader with a bottom up construction approach, which is
       also suitable for constructing Forest::Tree::Pure derived trees without
       excessive cloning.

       It provides a declarative API instead of	an imperative one, where
       "tree" is lazily	constructed on the first use, instead of being
       constructed immediately and "filled in" by the "load" method.

METHODS
       create_new_subtree
	   Implemented by Forest::Tree::Constructor

       _build_tree
	   Constructs a	root node by using the top level "subtrees" list as
	   the children.

       _build_subtrees
	   Build the subtrees.

	   Abstract method that	should return an array ref of
	   Forest::Tree::Pure derived objects.

SEE ALSO
       Forest::Tree::Builder::SimpleTextFile

BUGS
       All complex software has	bugs lurking in	it, and	this module is no
       exception. If you find a	bug please either email	me, or add the bug to
       cpan-RT.

AUTHOR
       Yuval Kogman

COPYRIGHT AND LICENSE
       Copyright 2008-2014 Infinity Interactive, Inc.

       <http://www.iinteractive.com>

       This library is free software; you can redistribute it and/or modify it
       under the same terms as Perl itself.

perl v5.32.0			  2013-12-18	      Forest::Tree::Builder(3)

NAME | SYNOPSIS | DESCRIPTION | METHODS | SEE ALSO | BUGS | AUTHOR | COPYRIGHT AND LICENSE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=Forest::Tree::Builder&sektion=3&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help