view release on metacpan or  search on metacpan

Locations.pm  view on Meta::CPAN

=item *

C<$location-E<gt>print(@items);>

This method prints the given list of arguments to the indicated
location, i.e., appends the given items to the given location.

IMPORTANT FEATURE:

Note that you can EMBED any given location IN MORE THAN ONE surrounding
location using this method!

Simply use a statement similar to this one:

        $location->print($sublocation);

This embeds location "C<$sublocation>" in location "C<$location>" at
the current position (defined by what has been printed to location
"C<$location>" till this moment).

Locations.pm  view on Meta::CPAN

location being dumped.

If you want to delete the given location once it has been dumped, you
need to call the method "C<delete()>" (explained below) explicitly.

=item *

C<$location-E<gt>delete();>

The method "C<delete()>" deletes the CONTENTS of the given location -
the location CONTINUES TO EXIST and REMAINS EMBEDDED where it was!

The associated filename stored along with the given location is also
NOT AFFECTED by this method.

BEWARE that any locations which were previously embedded in the given
location might go out of scope by invoking this method!

Note that in order to actually DESTROY a location altogether it suffices
to simply let the last reference to the location in question go out of
scope, or to set the variable containing the last reference to a new