Gecko [ georgetownmover.com ]

Name	Size	Permission	Date
perl.pod	16.08 KB	-rw-r--r--	2019-05-31 11:39
perl5004delta.pod	54.92 KB	-rw-r--r--	2019-05-31 11:39
perl5005delta.pod	33.48 KB	-rw-r--r--	2019-05-31 11:39
perl5100delta.pod	54.23 KB	-rw-r--r--	2019-05-31 11:39
perl5101delta.pod	42.86 KB	-rw-r--r--	2019-05-31 11:39
perl5120delta.pod	87.18 KB	-rw-r--r--	2019-05-31 11:39
perl5121delta.pod	9.9 KB	-rw-r--r--	2019-05-31 11:39
perl5122delta.pod	9.38 KB	-rw-r--r--	2019-05-31 11:39
perl5123delta.pod	4 KB	-rw-r--r--	2019-05-31 11:39
perl5124delta.pod	3.59 KB	-rw-r--r--	2019-05-31 11:39
perl5125delta.pod	7.5 KB	-rw-r--r--	2019-05-31 11:39
perl5140delta.pod	140.94 KB	-rw-r--r--	2019-05-31 11:39
perl5141delta.pod	7.78 KB	-rw-r--r--	2019-05-31 11:39
perl5142delta.pod	6.73 KB	-rw-r--r--	2019-05-31 11:39
perl5143delta.pod	7.58 KB	-rw-r--r--	2019-05-31 11:39
perl5144delta.pod	6.18 KB	-rw-r--r--	2019-05-31 11:39
perl5160delta.pod	130.52 KB	-rw-r--r--	2019-05-31 11:39
perl5161delta.pod	6 KB	-rw-r--r--	2019-05-31 11:39
perl5162delta.pod	3.51 KB	-rw-r--r--	2019-05-31 11:39
perl5163delta.pod	3.99 KB	-rw-r--r--	2019-05-31 11:39
perl5180delta.pod	116.63 KB	-rw-r--r--	2019-05-31 11:39
perl5181delta.pod	6.44 KB	-rw-r--r--	2019-05-31 11:39
perl5182delta.pod	5.21 KB	-rw-r--r--	2019-05-31 11:39
perl5184delta.pod	4.53 KB	-rw-r--r--	2019-05-31 11:39
perl5200delta.pod	112.99 KB	-rw-r--r--	2019-05-31 11:39
perl5201delta.pod	10.64 KB	-rw-r--r--	2019-05-31 11:39
perl5202delta.pod	12.22 KB	-rw-r--r--	2019-05-31 11:39
perl5203delta.pod	9.17 KB	-rw-r--r--	2019-05-31 11:39
perl5220delta.pod	127.89 KB	-rw-r--r--	2019-05-31 11:39
perl5221delta.pod	10.51 KB	-rw-r--r--	2019-05-31 11:39
perl5222delta.pod	12.33 KB	-rw-r--r--	2019-05-31 11:39
perl5223delta.pod	8.26 KB	-rw-r--r--	2019-05-31 11:39
perl5224delta.pod	4.36 KB	-rw-r--r--	2019-05-31 11:39
perl5240delta.pod	63.41 KB	-rw-r--r--	2019-05-31 11:39
perl5241delta.pod	8.02 KB	-rw-r--r--	2019-05-31 11:39
perl5242delta.pod	4.02 KB	-rw-r--r--	2019-05-31 11:39
perl5243delta.pod	11.16 KB	-rw-r--r--	2019-05-31 11:39
perl5244delta.pod	4.4 KB	-rw-r--r--	2019-05-31 11:39
perl5260delta.pod	99.45 KB	-rw-r--r--	2019-05-31 11:39
perl5261delta.pod	7.74 KB	-rw-r--r--	2019-05-31 11:39
perl5262delta.pod	7.7 KB	-rw-r--r--	2019-05-31 11:39
perl5263delta.pod	6.9 KB	-rw-r--r--	2019-05-31 11:39
perl5280delta.pod	70.42 KB	-rw-r--r--	2019-05-31 11:39
perl5281delta.pod	4.53 KB	-rw-r--r--	2019-05-31 11:39
perl5282delta.pod	6.05 KB	-rw-r--r--	2019-05-31 11:39
perl5300delta.pod	40.31 KB	-rw-r--r--	2019-05-31 11:39
perl561delta.pod	121.79 KB	-rw-r--r--	2019-05-31 11:39
perl56delta.pod	104.69 KB	-rw-r--r--	2019-05-31 11:39
perl581delta.pod	37.17 KB	-rw-r--r--	2019-05-31 11:39
perl582delta.pod	4.37 KB	-rw-r--r--	2019-05-31 11:39
perl583delta.pod	6.19 KB	-rw-r--r--	2019-05-31 11:39
perl584delta.pod	7.19 KB	-rw-r--r--	2019-05-31 11:39
perl585delta.pod	5.75 KB	-rw-r--r--	2019-05-31 11:39
perl586delta.pod	4.54 KB	-rw-r--r--	2019-05-31 11:39
perl587delta.pod	8.16 KB	-rw-r--r--	2019-05-31 11:39
perl588delta.pod	24.69 KB	-rw-r--r--	2019-05-31 11:39
perl589delta.pod	52.64 KB	-rw-r--r--	2019-05-31 11:39
perl58delta.pod	112.47 KB	-rw-r--r--	2019-05-31 11:39
perlaix.pod	19.96 KB	-rw-r--r--	2019-05-31 11:39
perlamiga.pod	5.61 KB	-rw-r--r--	2019-05-31 11:39
perlandroid.pod	7.69 KB	-rw-r--r--	2019-05-31 11:39
perlapi.pod	465.85 KB	-rw-r--r--	2019-05-31 11:39
perlapio.pod	18.83 KB	-rw-r--r--	2019-05-31 11:39
perlartistic.pod	6.85 KB	-rw-r--r--	2019-05-31 11:39
perlbook.pod	8.14 KB	-rw-r--r--	2019-05-31 11:39
perlboot.pod	294 B	-rw-r--r--	2019-05-31 11:39
perlbot.pod	304 B	-rw-r--r--	2019-05-31 11:39
perlbs2000.pod	7.87 KB	-rw-r--r--	2019-05-31 11:39
perlcall.pod	55.38 KB	-rw-r--r--	2019-05-31 11:39
perlce.pod	14.26 KB	-rw-r--r--	2019-05-31 11:39
perlcheat.pod	4.38 KB	-rw-r--r--	2019-05-31 11:39
perlclib.pod	9.42 KB	-rw-r--r--	2019-05-31 11:39
perlcn.pod	4.58 KB	-rw-r--r--	2019-05-31 11:39
perlcommunity.pod	7.05 KB	-rw-r--r--	2019-05-31 11:39
perlcygwin.pod	26.56 KB	-rw-r--r--	2019-05-31 11:39
perldata.pod	48.62 KB	-rw-r--r--	2019-05-31 11:39
perldbmfilter.pod	4.86 KB	-rw-r--r--	2019-05-31 11:39
perldebguts.pod	40.04 KB	-rw-r--r--	2019-05-31 11:39
perldebtut.pod	21.63 KB	-rw-r--r--	2019-05-31 11:39
perldebug.pod	38.46 KB	-rw-r--r--	2019-05-31 11:39
perldelta.pod	40.31 KB	-rw-r--r--	2019-05-31 11:39
perldeprecation.pod	19.79 KB	-rw-r--r--	2019-05-31 11:39
perldiag.pod	286.97 KB	-rw-r--r--	2019-05-31 11:39
perldoc.pod	9.16 KB	-rw-r--r--	2019-05-31 11:39
perldos.pod	10.28 KB	-rw-r--r--	2019-05-31 11:39
perldsc.pod	25.01 KB	-rw-r--r--	2019-05-31 11:39
perldtrace.pod	7.77 KB	-rw-r--r--	2019-05-31 11:39
perlebcdic.pod	82.36 KB	-rw-r--r--	2019-05-31 11:39
perlembed.pod	36.71 KB	-rw-r--r--	2019-05-31 11:39
perlexperiment.pod	7.08 KB	-rw-r--r--	2019-05-31 11:39
perlfaq.pod	22.22 KB	-rw-r--r--	2019-05-31 11:39
perlfaq1.pod	14.12 KB	-rw-r--r--	2019-05-31 11:39
perlfaq2.pod	9.24 KB	-rw-r--r--	2019-05-31 11:39
perlfaq3.pod	36.66 KB	-rw-r--r--	2019-05-31 11:39
perlfaq4.pod	87.5 KB	-rw-r--r--	2019-05-31 11:39
perlfaq5.pod	54.21 KB	-rw-r--r--	2019-05-31 11:39
perlfaq6.pod	38.73 KB	-rw-r--r--	2019-05-31 11:39
perlfaq7.pod	36.93 KB	-rw-r--r--	2019-05-31 11:39
perlfaq8.pod	48.93 KB	-rw-r--r--	2019-05-31 11:39
perlfaq9.pod	14.53 KB	-rw-r--r--	2019-05-31 11:39
perlfilter.pod	21.75 KB	-rw-r--r--	2019-05-31 11:39
perlfork.pod	13.04 KB	-rw-r--r--	2019-05-31 11:39
perlform.pod	16.22 KB	-rw-r--r--	2019-05-31 11:39
perlfreebsd.pod	1.57 KB	-rw-r--r--	2019-05-31 11:39
perlfunc.pod	389.67 KB	-rw-r--r--	2019-05-31 11:39
perlgit.pod	33.26 KB	-rw-r--r--	2019-05-31 11:39
perlglossary.pod	134.02 KB	-rw-r--r--	2019-05-31 11:39
perlgpl.pod	13.49 KB	-rw-r--r--	2019-05-31 11:39
perlguts.pod	144.5 KB	-rw-r--r--	2019-05-31 11:39
perlhack.pod	42.18 KB	-rw-r--r--	2019-05-31 11:39
perlhacktips.pod	54.17 KB	-rw-r--r--	2019-05-31 11:39
perlhacktut.pod	6.01 KB	-rw-r--r--	2019-05-31 11:39
perlhaiku.pod	1.47 KB	-rw-r--r--	2019-05-31 11:39
perlhist.pod	53.13 KB	-rw-r--r--	2019-05-31 11:39
perlhpux.pod	29.89 KB	-rw-r--r--	2019-05-31 11:39
perlhurd.pod	1.95 KB	-rw-r--r--	2019-05-31 11:39
perlintern.pod	69.74 KB	-rw-r--r--	2019-05-31 11:39
perlinterp.pod	32.92 KB	-rw-r--r--	2019-05-31 11:39
perlintro.pod	21.6 KB	-rw-r--r--	2019-05-31 11:39
perliol.pod	33.99 KB	-rw-r--r--	2019-05-31 11:39
perlipc.pod	69.18 KB	-rw-r--r--	2019-05-31 11:39
perlirix.pod	4.29 KB	-rw-r--r--	2019-05-31 11:39
perljp.pod	7.34 KB	-rw-r--r--	2019-05-31 11:39
perlko.pod	11.97 KB	-rw-r--r--	2019-05-31 11:39
perllexwarn.pod	355 B	-rw-r--r--	2019-05-31 11:39
perllinux.pod	1.45 KB	-rw-r--r--	2019-05-31 11:39
perllocale.pod	71.9 KB	-rw-r--r--	2019-05-31 11:39
perllol.pod	9.36 KB	-rw-r--r--	2019-05-31 11:39
perlmacos.pod	1001 B	-rw-r--r--	2019-05-31 11:39
perlmacosx.pod	11.78 KB	-rw-r--r--	2019-05-31 11:39
perlmod.pod	25.58 KB	-rw-r--r--	2019-05-31 11:39
perlmodinstall.pod	9.97 KB	-rw-r--r--	2019-05-31 11:39
perlmodlib.pod	74.76 KB	-rw-r--r--	2019-05-31 11:39
perlmodstyle.pod	22.05 KB	-rw-r--r--	2019-05-31 11:39
perlmroapi.pod	3.14 KB	-rw-r--r--	2019-05-31 11:39
perlnetware.pod	6.49 KB	-rw-r--r--	2019-05-31 11:39
perlnewmod.pod	10.78 KB	-rw-r--r--	2019-05-31 11:39
perlnumber.pod	8.16 KB	-rw-r--r--	2019-05-31 11:39
perlobj.pod	34.88 KB	-rw-r--r--	2019-05-31 11:39
perlootut.pod	26.16 KB	-rw-r--r--	2019-05-31 11:39
perlop.pod	139.05 KB	-rw-r--r--	2019-05-31 11:39
perlopenbsd.pod	1.18 KB	-rw-r--r--	2019-05-31 11:39
perlopentut.pod	9.23 KB	-rw-r--r--	2019-05-31 11:39
perlos2.pod	91.16 KB	-rw-r--r--	2019-05-31 11:39
perlos390.pod	15.31 KB	-rw-r--r--	2019-05-31 11:39
perlos400.pod	4.66 KB	-rw-r--r--	2019-05-31 11:39
perlpacktut.pod	50.08 KB	-rw-r--r--	2019-05-31 11:39
perlperf.pod	48.71 KB	-rw-r--r--	2019-05-31 11:39
perlplan9.pod	5 KB	-rw-r--r--	2019-05-31 11:39
perlpod.pod	21.68 KB	-rw-r--r--	2019-05-31 11:39
perlpodspec.pod	66.88 KB	-rw-r--r--	2019-05-31 11:39
perlpodstyle.pod	11.81 KB	-rw-r--r--	2019-05-31 11:39
perlpolicy.pod	25.5 KB	-rw-r--r--	2019-05-31 11:39
perlport.pod	86.57 KB	-rw-r--r--	2019-05-31 11:39
perlpragma.pod	5.05 KB	-rw-r--r--	2019-05-31 11:39
perlqnx.pod	6.52 KB	-rw-r--r--	2019-05-31 11:39
perlre.pod	128.52 KB	-rw-r--r--	2019-05-31 11:39
perlreapi.pod	29.54 KB	-rw-r--r--	2019-05-31 11:39
perlrebackslash.pod	31.53 KB	-rw-r--r--	2019-05-31 11:39
perlrecharclass.pod	48.52 KB	-rw-r--r--	2019-05-31 11:39
perlref.pod	34.47 KB	-rw-r--r--	2019-05-31 11:39
perlreftut.pod	18.38 KB	-rw-r--r--	2019-05-31 11:39
perlreguts.pod	37.43 KB	-rw-r--r--	2019-05-31 11:39
perlrepository.pod	509 B	-rw-r--r--	2019-05-31 11:39
perlrequick.pod	18.69 KB	-rw-r--r--	2019-05-31 11:39
perlreref.pod	14.72 KB	-rw-r--r--	2019-05-31 11:39
perlretut.pod	119.26 KB	-rw-r--r--	2019-05-31 11:39
perlriscos.pod	1.49 KB	-rw-r--r--	2019-05-31 11:39
perlrun.pod	53.08 KB	-rw-r--r--	2019-05-31 11:39
perlsec.pod	27.55 KB	-rw-r--r--	2019-05-31 11:39
perlsolaris.pod	29.12 KB	-rw-r--r--	2019-05-31 11:39
perlsource.pod	6.71 KB	-rw-r--r--	2019-05-31 11:39
perlstyle.pod	8.43 KB	-rw-r--r--	2019-05-31 11:39
perlsub.pod	72.45 KB	-rw-r--r--	2019-05-31 11:39
perlsymbian.pod	14.98 KB	-rw-r--r--	2019-05-31 11:39
perlsyn.pod	43.94 KB	-rw-r--r--	2019-05-31 11:39
perlsynology.pod	7.77 KB	-rw-r--r--	2019-05-31 11:39
perlthrtut.pod	45.37 KB	-rw-r--r--	2019-05-31 11:39
perltie.pod	37.84 KB	-rw-r--r--	2019-05-31 11:39
perltoc.pod	680.17 KB	-rw-r--r--	2019-05-31 11:39
perltodo.pod	376 B	-rw-r--r--	2019-05-31 11:39
perltooc.pod	294 B	-rw-r--r--	2019-05-31 11:39
perltoot.pod	294 B	-rw-r--r--	2019-05-31 11:39
perltrap.pod	10.37 KB	-rw-r--r--	2019-05-31 11:39
perltru64.pod	8.29 KB	-rw-r--r--	2019-05-31 11:39
perltw.pod	4.37 KB	-rw-r--r--	2019-05-31 11:39
perlunicode.pod	86.49 KB	-rw-r--r--	2019-05-31 11:39
perlunicook.pod	24.89 KB	-rw-r--r--	2019-05-31 11:39
perlunifaq.pod	13.33 KB	-rw-r--r--	2019-05-31 11:39
perluniintro.pod	37.6 KB	-rw-r--r--	2019-05-31 11:39
perluniprops.pod	416.55 KB	-rw-r--r--	2019-05-31 11:39
perlunitut.pod	7.76 KB	-rw-r--r--	2019-05-31 11:39
perlutil.pod	7.46 KB	-rw-r--r--	2019-05-31 11:39
perlvar.pod	78.73 KB	-rw-r--r--	2019-05-31 11:39
perlvms.pod	49.63 KB	-rw-r--r--	2019-05-31 11:39
perlvos.pod	3.75 KB	-rw-r--r--	2019-05-31 11:39
perlwin32.pod	39.63 KB	-rw-r--r--	2019-05-31 11:39
perlxs.pod	82.35 KB	-rw-r--r--	2019-05-31 11:39
perlxstut.pod	48.92 KB	-rw-r--r--	2019-05-31 11:39
perlxstypemap.pod	23.44 KB	-rw-r--r--	2019-05-31 11:39

Rename

=head1 NAME

perlmroapi - Perl method resolution plugin interface

=head1 DESCRIPTION

As of Perl 5.10.1 there is a new interface for plugging and using method
resolution orders other than the default (linear depth first search).
The C3 method resolution order added in 5.10.0 has been re-implemented as
a plugin, without changing its Perl-space interface.

Each plugin should register itself by providing
the following structure

struct mro_alg {
        AV *(*resolve)(pTHX_ HV *stash, U32 level);
        const char *name;
        U16 length;
        U16 kflags;
        U32 hash;
    };

and calling C<Perl_mro_register>:

Perl_mro_register(aTHX_ &my_mro_alg);

=over 4

=item resolve

Pointer to the linearisation function, described below.

=item name

Name of the MRO, either in ISO-8859-1 or UTF-8.

=item length

Length of the name.

=item kflags

If the name is given in UTF-8, set this to C<HVhek_UTF8>. The value is passed
direct as the parameter I<kflags> to C<hv_common()>.

=item hash

A precomputed hash value for the MRO's name, or 0.

=back

=head1 Callbacks

The C<resolve> function is called to generate a linearised ISA for the
given stash, using this MRO. It is called with a pointer to the stash, and
a I<level> of 0. The core always sets I<level> to 0 when it calls your
function - the parameter is provided to allow your implementation to track
depth if it needs to recurse.

The function should return a reference to an array containing the parent
classes in order. The names of the classes should be the result of calling
C<HvENAME()> on the stash. In those cases where C<HvENAME()> returns null,
C<HvNAME()> should be used instead.

The caller is responsible for incrementing the reference count of the array
returned if it wants to keep the structure. Hence, if you have created a
temporary value that you keep no pointer to, C<sv_2mortal()> to ensure that
it is disposed of correctly. If you have cached your return value, then
return a pointer to it without changing the reference count.

=head1 Caching

Computing MROs can be expensive. The implementation provides a cache, in
which you can store a single C<SV *>, or anything that can be cast to
C<SV *>, such as C<AV *>. To read your private value, use the macro
C<MRO_GET_PRIVATE_DATA()>, passing it the C<mro_meta> structure from the
stash, and a pointer to your C<mro_alg> structure:

meta = HvMROMETA(stash);
    private_sv = MRO_GET_PRIVATE_DATA(meta, &my_mro_alg);

To set your private value, call C<Perl_mro_set_private_data()>:

Perl_mro_set_private_data(aTHX_ meta, &c3_alg, private_sv);

The private data cache will take ownership of a reference to private_sv,
much the same way that C<hv_store()> takes ownership of a reference to the
value that you pass it.

=head1 Examples

For examples of MRO implementations, see C<S_mro_get_linear_isa_c3()>
and the C<BOOT:> section of F<ext/mro/mro.xs>, and
C<S_mro_get_linear_isa_dfs()> in F<mro_core.c>

=head1 AUTHORS

The implementation of the C3 MRO and switchable MROs within the perl core was
written by Brandon L Black. Nicholas Clark created the pluggable interface, 
refactored Brandon's implementation to work with it, and wrote this document.

=cut