Unix/Linux Go Back    


CentOS 7.0 - man page for ppi::document::file (centos section 3)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


PPI::Document::File(3)	       User Contributed Perl Documentation	   PPI::Document::File(3)

NAME
       PPI::Document::File - A Perl Document located in a specific file

DESCRIPTION
       WARNING: This class is experimental, and may change without notice

       PPI::Document::File provides a PPI::Document subclass that represents a Perl document
       stored in a specific named file.

METHODS
   new
	 my $file = PPI::Document::File->new( 'Module.pm' );

       The "new" constructor works the same as for the regular one, except that the only params
       allowed is a file name. You cannot create an "anonymous" PPI::Document::File object, not
       can you create an empty one.

       Returns a new PPI::Document::File object, or "undef" on error.

   filename
       The "filename" accessor returns the name of the file in which the document is stored.

   save
	 # Save to the file we were loaded from
	 $file->save;

	 # Save a copy to somewhere else
	 $file->save( 'Module2.pm' );

       The "save" method works similarly to the one in the parent PPI::Document class, saving a
       copy of the document to a file.

       The difference with this subclass is that if "save" is not passed any filename, it will
       save it back to the file it was loaded from.

       Note: When saving to a different file, it is considered to be saving a copy and so the
       value returned by the "filename" accessor will stay the same, and not change to the new
       filename.

TO DO
       - May need to overload some methods to forcefully prevent Document objects becoming
       children of another Node.

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.

perl v5.16.3				    2011-02-26			   PPI::Document::File(3)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 03:52 AM.