++ed by:
ADAMJS RRWO

2 PAUSE user(s)
1 non-PAUSE user(s).

Steven Haryanto

NAME

Org::Element - Base class for Org document elements

VERSION

This document describes version 0.38 of Org::Element (from Perl distribution Org-Parser), released on 2014-05-17.

SYNOPSIS

 # Don't use directly, use the other Org::Element::* classes.

DESCRIPTION

This is the base class for all the other Org element classes.

ATTRIBUTES

document => DOCUMENT

Link to document object. Elements need this to access file-wide settings, properties, etc.

parent => undef | ELEMENT

Link to parent element. Undef if this element is the root element.

children => undef | ARRAY_OF_ELEMENTS

METHODS

$el->children_as_string() => STR

Return a concatenation of children's as_string(), or "" if there are no children.

$el->as_string() => STR

Return the string representation of element. The default implementation will just use _str (if defined) concatenated with children_as_string().

$el->seniority => INT

Find out the ranking of brothers/sisters of all sibling. If we are the first child of parent, return 0. If we are the second child, return 1, and so on.

$el->prev_sibling() => ELEMENT | undef

$el->next_sibling() => ELEMENT | undef

$el->extra_walkables => LIST

Return extra walkable elements. The default is to return an empty list, but some elements can have this, for Org::Element::Headline's title is also a walkable element.

$el->walk(CODEREF)

Call CODEREF for node and all descendent nodes (and extra walkables), depth-first. Code will be given the element object as argument.

$el->find(CRITERIA) => ELEMENTS

Find subelements. CRITERIA can be a word (e.g. 'Headline' meaning of class 'Org::Element::Headline') or a class name ('Org::Element::ListItem') or a coderef (which will be given the element to test). Will return matched elements.

$el->walk_parents(CODE)

Run CODEREF for parent, and its parent, and so on until the root element (the document), or until CODEREF returns a false value. CODEREF will be supplied ($el, $parent). Will return the last parent walked.

$el->headline() => ELEMENT

Get current headline.

$el->field_name() => STR

Try to extract "field name", being defined as either some text on the left side:

 DEADLINE: <2011-06-09 >

or a description term in a description list:

 - wedding anniversary :: <2011-06-10 >

$el->remove()

Remove element from the tree. Basically just remove the element from its parent.

HOMEPAGE

Please visit the project's homepage at https://metacpan.org/release/Org-Parser.

SOURCE

Source repository is at https://github.com/sharyanto/perl-Org-Parser.

BUGS

Please report any bugs or feature requests on the bugtracker website https://rt.cpan.org/Public/Dist/Display.html?Name=Org-Parser

When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.

AUTHOR

Steven Haryanto <stevenharyanto@gmail.com>

COPYRIGHT AND LICENSE

This software is copyright (c) 2014 by Steven Haryanto.

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




Hosting generously
sponsored by Bytemark