晋太元中,武陵人捕鱼为业。缘溪行,忘路之远近。忽逢桃花林,夹岸数百步,中无杂树,芳草鲜美,落英缤纷。渔人甚异之,复前行,欲穷其林。 林尽水源,便得一山,山有小口,仿佛若有光。便舍船,从口入。初极狭,才通人。复行数十步,豁然开朗。土地平旷,屋舍俨然,有良田、美池、桑竹之属。阡陌交通,鸡犬相闻。其中往来种作,男女衣着,悉如外人。黄发垂髫,并怡然自乐。 见渔人,乃大惊,问所从来。具答之。便要还家,设酒杀鸡作食。村中闻有此人,咸来问讯。自云先世避秦时乱,率妻子邑人来此绝境,不复出焉,遂与外人间隔。问今是何世,乃不知有汉,无论魏晋。此人一一为具言所闻,皆叹惋。余人各复延至其家,皆出酒食。停数日,辞去。此中人语云:“不足为外人道也。”(间隔 一作:隔绝) 既出,得其船,便扶向路,处处志之。及郡下,诣太守,说如此。太守即遣人随其往,寻向所志,遂迷,不复得路。 南阳刘子骥,高尚士也,闻之,欣然规往。未果,寻病终。后遂无问津者。
|
Server : Apache System : Linux srv.rainic.com 4.18.0-553.47.1.el8_10.x86_64 #1 SMP Wed Apr 2 05:45:37 EDT 2025 x86_64 User : rainic ( 1014) PHP Version : 7.4.33 Disable Function : exec,passthru,shell_exec,system Directory : /usr/share/perl5/vendor_perl/Package/ |
Upload File : |
use strict;
use warnings;
package Package::Reaper;
{
$Package::Reaper::VERSION = '1.106';
}
use 5.008;
# ABSTRACT: pseudo-garbage-collection for packages
use Carp ();
use Symbol ();
sub new {
my ($class, $package) = @_;
# Do I care about checking $package with _CLASS and/or exists_package?
# Probably not, for now. -- rjbs, 2006-06-05
my $self = [ $package, 1 ];
bless $self => $class;
}
sub package {
my $self = shift;
Carp::croak "a reaper's package may not be altered" if @_;
return $self->[0];
}
sub is_armed {
my $self = shift;
return $self->[1] == 1;
}
sub disarm { $_[0]->[1] = 0 }
sub arm { $_[0]->[1] = 1 }
sub DESTROY {
my ($self) = @_;
return unless $self->is_armed;
my $package = $self->package;
Symbol::delete_package($package);
}
"You might be a king or a little street sweeper, but sooner or later you dance
with Package:Reaper.";
__END__
=pod
=encoding UTF-8
=head1 NAME
Package::Reaper - pseudo-garbage-collection for packages
=head1 VERSION
version 1.106
=head1 SYNOPSIS
use Package::Generator;
use Package::Reaper;
{
my $package = Package::Generator->new_package;
my $reaper = Package::Reaper->new($package);
...
}
# at this point, $package stash has been deleted
=head1 DESCRIPTION
This module allows you to create simple objects which, when destroyed, delete a
given package. This lets you approximate lexically scoped packages.
=head1 INTERFACE
=head2 new
my $reaper = Package::Reaper->new($package);
This returns the newly generated package reaper. When the reaper goes out of
scope and is garbage collected, it will delete the symbol table entry for the
package.
=head2 package
my $package = $reaper->package;
This method returns the package which will be reaped.
=head2 is_armed
if ($reaper->is_armed) { ... }
This method returns true if the reaper is armed and false otherwise. Reapers
always start out armed. A disarmed reaper will not actually reap when
destroyed.
=head2 disarm
$reaper->disarm;
This method disarms the reaper, so that it will not reap the package when it is
destroyed.
=head2 arm
$reaper->arm;
This method arms the reaper, so that it will reap its package when it is
destroyed. By default, new reapers are armed.
=head1 AUTHOR
Ricardo SIGNES <rjbs@cpan.org>
=head1 COPYRIGHT AND LICENSE
This software is copyright (c) 2005 by Ricardo SIGNES.
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.
=cut