Adam Kennedy > PPI > PPI::Document::Fragment

Download:
PPI-1.215.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  31
Open  31
View/Report Bugs
Module Version: 1.215   Source   Latest Release: PPI-1.218

NAME ^

PPI::Document::Fragment - A fragment of a Perl Document

DESCRIPTION ^

In some situations you might want to work with a fragment of a larger document. PPI::Document::Fragment is a class intended for this purpose. It is functionally almost identical to a normal PPI::Document, except that it is not possible to get line/column positions for the elements within it, and it does not represent a scope.

METHODS ^

index_locations

Unlike when called on a PPI::Document object, you should not be attempting to find locations of things within a PPI::Document::Fragment, and thus any call to the index_locations will print a warning and return undef instead of attempting to index the locations of the Elements.

TO DO ^

Integrate this into the rest of PPI so it has actual practical uses. The most obvious would be to implement arbitrary cut/copy/paste more easily.

SUPPORT ^

See the support section in the main module.

AUTHOR ^

Adam Kennedy <adamk@cpan.org>

COPYRIGHT ^

Copyright 2001 - 2011 Adam Kennedy.

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

The full text of the license can be found in the LICENSE file included with this module.

syntax highlighting: