NAME

dtRdr::NoteThread - an n-ary tree of notes

SYNOPSIS

  my (@threads) = dtRdr::NoteThread->create(@notes);

Method Names

Most of the methods from Tree::Simple have been aliased to a lowercase+underscores, terse naming convention (e.g. 'getParent' becomes 'parent', 'getDepth' => 'depth', 'getAllChildren' => 'children', etc.)

id

The thread id (getUID) is the note id.

note

Returns the note object (getNodeValue.)

If possible, use the aliases to work with this package. In the case that I find time to write Tree::Simpler, the javaLike names will vanish.

Identifier Methods

A notethread needs to pretend to be an annotation (in some contexts), so we implement these identifiers.

IS_RANGE_TYPE

true

ANNOTATION_TYPE

notethread

Class Methods

create

Sorts through a pile of notes and turns them all into threads.

  my (@threads) = dtRdr::NoteThread->create(@notes);

The threads will be in arbitrary order.

dummy

Creates a dummy note. Copies all of the attributes from the descendant note (in the same thread), except the id and references.

  my $note = dtRdr::NoteThread->dummy($id, $descendant);

Constructor

new

See Tree::Simple.

  my $thread = dtRdr::NoteThread->new($note, $parent);

Methods

rmap

Depth-first recursion. At each level, $sub is called as $sub->($node, \%ctrl).

The %ctrl hash allows you to send commands back to the dispatcher.

  my $sub = sub {
    my ($node, $ctrl) = @_;
    if(something($node)) {
      $ctrl->{prune} = 1; # do not follow children
    }
  };
  $tree->rmap($sub);

AUTHOR

Eric Wilhelm <ewilhelm at cpan dot org>

http://scratchcomputing.com/

COPYRIGHT

Copyright (C) 2007 Eric L. Wilhelm and OSoft, All Rights Reserved.

NO WARRANTY

Absolutely, positively NO WARRANTY, neither express or implied, is offered with this software. You use this software at your own risk. In case of loss, no person or entity owes you anything whatsoever. You have been warned.

LICENSE

The dotReader(TM) is OSI Certified Open Source Software licensed under the GNU General Public License (GPL) Version 2, June 1991. Non-encrypted and encrypted packages are usable in connection with the dotReader(TM). The ability to create, edit, or otherwise modify content of such encrypted packages is self-contained within the packages, and NOT provided by the dotReader(TM), and is addressed in a separate commercial license.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

cpanm dtRdr

perl -MCPAN -e shell
install dtRdr