Gecko [ goons4good.org ]

Name	Size	Permission	Date
a2p.pod	5.96 KB	-rw-r--r--	2026-01-13 09:57
perl.pod	15.43 KB	-rw-r--r--	2026-01-13 09:57
perl5004delta.pod	54.92 KB	-rw-r--r--	2026-01-13 09:57
perl5005delta.pod	33.48 KB	-rw-r--r--	2026-01-13 09:57
perl5100delta.pod	53.41 KB	-rw-r--r--	2026-01-13 09:57
perl5101delta.pod	42.86 KB	-rw-r--r--	2026-01-13 09:57
perl5120delta.pod	87.19 KB	-rw-r--r--	2026-01-13 09:57
perl5121delta.pod	9.91 KB	-rw-r--r--	2026-01-13 09:57
perl5122delta.pod	9.38 KB	-rw-r--r--	2026-01-13 09:57
perl5123delta.pod	4 KB	-rw-r--r--	2026-01-13 09:57
perl5124delta.pod	3.59 KB	-rw-r--r--	2026-01-13 09:57
perl5140delta.pod	140.94 KB	-rw-r--r--	2026-01-13 09:57
perl5141delta.pod	7.78 KB	-rw-r--r--	2026-01-13 09:57
perl5142delta.pod	6.73 KB	-rw-r--r--	2026-01-13 09:57
perl5143delta.pod	7.58 KB	-rw-r--r--	2026-01-13 09:57
perl5160delta.pod	130.52 KB	-rw-r--r--	2026-01-13 09:57
perl5161delta.pod	6 KB	-rw-r--r--	2026-01-13 09:57
perl5162delta.pod	3.51 KB	-rw-r--r--	2026-01-13 09:57
perl5163delta.pod	3.99 KB	-rw-r--r--	2026-01-13 09:57
perl561delta.pod	121.79 KB	-rw-r--r--	2026-01-13 09:57
perl56delta.pod	104.68 KB	-rw-r--r--	2026-01-13 09:57
perl581delta.pod	37.17 KB	-rw-r--r--	2026-01-13 09:57
perl582delta.pod	4.37 KB	-rw-r--r--	2026-01-13 09:57
perl583delta.pod	6.19 KB	-rw-r--r--	2026-01-13 09:57
perl584delta.pod	7.19 KB	-rw-r--r--	2026-01-13 09:57
perl585delta.pod	5.75 KB	-rw-r--r--	2026-01-13 09:57
perl586delta.pod	4.54 KB	-rw-r--r--	2026-01-13 09:57
perl587delta.pod	8.16 KB	-rw-r--r--	2026-01-13 09:57
perl588delta.pod	24.68 KB	-rw-r--r--	2026-01-13 09:57
perl589delta.pod	52.64 KB	-rw-r--r--	2026-01-13 09:57
perl58delta.pod	112.21 KB	-rw-r--r--	2026-01-13 09:57
perlaix.pod	18.77 KB	-rw-r--r--	2026-01-13 09:57
perlamiga.pod	6.87 KB	-rw-r--r--	2026-01-13 09:57
perlapi.pod	315.46 KB	-rw-r--r--	2026-01-13 09:57
perlapio.pod	18.88 KB	-rw-r--r--	2026-01-13 09:57
perlartistic.pod	6.85 KB	-rw-r--r--	2026-01-13 09:57
perlbeos.pod	2.87 KB	-rw-r--r--	2026-01-13 09:57
perlbook.pod	7.19 KB	-rw-r--r--	2026-01-13 09:57
perlboot.pod	183 B	-rw-r--r--	2026-01-13 09:57
perlbot.pod	182 B	-rw-r--r--	2026-01-13 09:57
perlbs2000.pod	7.73 KB	-rw-r--r--	2026-01-13 09:57
perlcall.pod	54.03 KB	-rw-r--r--	2026-01-13 09:57
perlce.pod	8.72 KB	-rw-r--r--	2026-01-13 09:57
perlcheat.pod	4.39 KB	-rw-r--r--	2026-01-13 09:57
perlclib.pod	7.5 KB	-rw-r--r--	2026-01-13 09:57
perlcn.pod	4.82 KB	-rw-r--r--	2026-01-13 09:57
perlcommunity.pod	6.29 KB	-rw-r--r--	2026-01-13 09:57
perlcygwin.pod	27.17 KB	-rw-r--r--	2026-01-13 09:57
perldata.pod	36.33 KB	-rw-r--r--	2026-01-13 09:57
perldbmfilter.pod	4.86 KB	-rw-r--r--	2026-01-13 09:57
perldebguts.pod	36.79 KB	-rw-r--r--	2026-01-13 09:57
perldebtut.pod	20.79 KB	-rw-r--r--	2026-01-13 09:57
perldebug.pod	38.15 KB	-rw-r--r--	2026-01-13 09:57
perldelta.pod	3.99 KB	-rw-r--r--	2026-01-13 09:57
perldgux.pod	2.75 KB	-rw-r--r--	2026-01-13 09:57
perldiag.pod	207.82 KB	-rw-r--r--	2026-01-13 09:57
perldos.pod	10.28 KB	-rw-r--r--	2026-01-13 09:57
perldsc.pod	24.84 KB	-rw-r--r--	2026-01-13 09:57
perldtrace.pod	6.21 KB	-rw-r--r--	2026-01-13 09:57
perlebcdic.pod	67.61 KB	-rw-r--r--	2026-01-13 09:57
perlembed.pod	35.21 KB	-rw-r--r--	2026-01-13 09:57
perlepoc.pod	3.57 KB	-rw-r--r--	2026-01-13 09:57
perlexperiment.pod	4.84 KB	-rw-r--r--	2026-01-13 09:57
perlfaq.pod	22.01 KB	-rw-r--r--	2026-01-13 09:57
perlfaq1.pod	13.52 KB	-rw-r--r--	2026-01-13 09:57
perlfaq2.pod	9.28 KB	-rw-r--r--	2026-01-13 09:57
perlfaq3.pod	37.46 KB	-rw-r--r--	2026-01-13 09:57
perlfaq4.pod	87.39 KB	-rw-r--r--	2026-01-13 09:57
perlfaq5.pod	54.11 KB	-rw-r--r--	2026-01-13 09:57
perlfaq6.pod	38.66 KB	-rw-r--r--	2026-01-13 09:57
perlfaq7.pod	36.35 KB	-rw-r--r--	2026-01-13 09:57
perlfaq8.pod	48.28 KB	-rw-r--r--	2026-01-13 09:57
perlfaq9.pod	14.71 KB	-rw-r--r--	2026-01-13 09:57
perlfork.pod	12.78 KB	-rw-r--r--	2026-01-13 09:57
perlform.pod	16.29 KB	-rw-r--r--	2026-01-13 09:57
perlfreebsd.pod	1.55 KB	-rw-r--r--	2026-01-13 09:57
perlfunc.pod	338.43 KB	-rw-r--r--	2026-01-13 09:57
perlgit.pod	29.75 KB	-rw-r--r--	2026-01-13 09:57
perlglossary.pod	110.66 KB	-rw-r--r--	2026-01-13 09:57
perlgpl.pod	13.54 KB	-rw-r--r--	2026-01-13 09:57
perlguts.pod	111.66 KB	-rw-r--r--	2026-01-13 09:57
perlhack.pod	35.03 KB	-rw-r--r--	2026-01-13 09:57
perlhacktips.pod	45.5 KB	-rw-r--r--	2026-01-13 09:57
perlhacktut.pod	6.07 KB	-rw-r--r--	2026-01-13 09:57
perlhaiku.pod	1.47 KB	-rw-r--r--	2026-01-13 09:57
perlhist.pod	43.32 KB	-rw-r--r--	2026-01-13 09:57
perlhpux.pod	28.07 KB	-rw-r--r--	2026-01-13 09:57
perlhurd.pod	1.94 KB	-rw-r--r--	2026-01-13 09:57
perlintern.pod	42.53 KB	-rw-r--r--	2026-01-13 09:57
perlinterp.pod	30 KB	-rw-r--r--	2026-01-13 09:57
perlintro.pod	22.08 KB	-rw-r--r--	2026-01-13 09:57
perliol.pod	33.03 KB	-rw-r--r--	2026-01-13 09:57
perlipc.pod	70.17 KB	-rw-r--r--	2026-01-13 09:57
perlirix.pod	4.29 KB	-rw-r--r--	2026-01-13 09:57
perljp.pod	7.57 KB	-rw-r--r--	2026-01-13 09:57
perlko.pod	7.52 KB	-rw-r--r--	2026-01-13 09:57
perllexwarn.pod	14.61 KB	-rw-r--r--	2026-01-13 09:57
perllinux.pod	1.45 KB	-rw-r--r--	2026-01-13 09:57
perllocale.pod	51.43 KB	-rw-r--r--	2026-01-13 09:57
perllol.pod	10.93 KB	-rw-r--r--	2026-01-13 09:57
perlmacos.pod	1001 B	-rw-r--r--	2026-01-13 09:57
perlmacosx.pod	10.4 KB	-rw-r--r--	2026-01-13 09:57
perlmod.pod	24.04 KB	-rw-r--r--	2026-01-13 09:57
perlmodinstall.pod	12.41 KB	-rw-r--r--	2026-01-13 09:57
perlmodlib.pod	78.49 KB	-rw-r--r--	2026-01-13 09:57
perlmodstyle.pod	20.76 KB	-rw-r--r--	2026-01-13 09:57
perlmpeix.pod	14.24 KB	-rw-r--r--	2026-01-13 09:57
perlmroapi.pod	3.13 KB	-rw-r--r--	2026-01-13 09:57
perlnetware.pod	6.35 KB	-rw-r--r--	2026-01-13 09:57
perlnewmod.pod	10.95 KB	-rw-r--r--	2026-01-13 09:57
perlnumber.pod	8.16 KB	-rw-r--r--	2026-01-13 09:57
perlobj.pod	33.65 KB	-rw-r--r--	2026-01-13 09:57
perlootut.pod	25.6 KB	-rw-r--r--	2026-01-13 09:57
perlop.pod	121.73 KB	-rw-r--r--	2026-01-13 09:57
perlopenbsd.pod	1.18 KB	-rw-r--r--	2026-01-13 09:57
perlopentut.pod	37.53 KB	-rw-r--r--	2026-01-13 09:57
perlos2.pod	90.53 KB	-rw-r--r--	2026-01-13 09:57
perlos390.pod	15.2 KB	-rw-r--r--	2026-01-13 09:57
perlos400.pod	4.51 KB	-rw-r--r--	2026-01-13 09:57
perlpacktut.pod	49.83 KB	-rw-r--r--	2026-01-13 09:57
perlperf.pod	50.05 KB	-rw-r--r--	2026-01-13 09:57
perlplan9.pod	5 KB	-rw-r--r--	2026-01-13 09:57
perlpod.pod	21.27 KB	-rw-r--r--	2026-01-13 09:57
perlpodspec.pod	66.2 KB	-rw-r--r--	2026-01-13 09:57
perlpolicy.pod	19.73 KB	-rw-r--r--	2026-01-13 09:57
perlport.pod	82.63 KB	-rw-r--r--	2026-01-13 09:57
perlpragma.pod	5.11 KB	-rw-r--r--	2026-01-13 09:57
perlqnx.pod	4.14 KB	-rw-r--r--	2026-01-13 09:57
perlre.pod	100.76 KB	-rw-r--r--	2026-01-13 09:57
perlreapi.pod	25.17 KB	-rw-r--r--	2026-01-13 09:57
perlrebackslash.pod	25.64 KB	-rw-r--r--	2026-01-13 09:57
perlrecharclass.pod	34.19 KB	-rw-r--r--	2026-01-13 09:57
perlref.pod	28.32 KB	-rw-r--r--	2026-01-13 09:57
perlreftut.pod	18.23 KB	-rw-r--r--	2026-01-13 09:57
perlreguts.pod	36 KB	-rw-r--r--	2026-01-13 09:57
perlrequick.pod	17.5 KB	-rw-r--r--	2026-01-13 09:57
perlreref.pod	14.19 KB	-rw-r--r--	2026-01-13 09:57
perlretut.pod	115.13 KB	-rw-r--r--	2026-01-13 09:57
perlriscos.pod	1.49 KB	-rw-r--r--	2026-01-13 09:57
perlrun.pod	49.58 KB	-rw-r--r--	2026-01-13 09:57
perlsec.pod	22.77 KB	-rw-r--r--	2026-01-13 09:57
perlsolaris.pod	28.63 KB	-rw-r--r--	2026-01-13 09:57
perlsource.pod	6.19 KB	-rw-r--r--	2026-01-13 09:57
perlstyle.pod	8.42 KB	-rw-r--r--	2026-01-13 09:57
perlsub.pod	55.15 KB	-rw-r--r--	2026-01-13 09:57
perlsymbian.pod	15.44 KB	-rw-r--r--	2026-01-13 09:57
perlsyn.pod	41.04 KB	-rw-r--r--	2026-01-13 09:57
perlthrtut.pod	45.41 KB	-rw-r--r--	2026-01-13 09:57
perltie.pod	37.02 KB	-rw-r--r--	2026-01-13 09:57
perltoc.pod	639 KB	-rw-r--r--	2026-01-13 09:57
perltodo.pod	362 B	-rw-r--r--	2026-01-13 09:57
perltooc.pod	183 B	-rw-r--r--	2026-01-13 09:57
perltoot.pod	183 B	-rw-r--r--	2026-01-13 09:57
perltrap.pod	40.28 KB	-rw-r--r--	2026-01-13 09:57
perltru64.pod	7.55 KB	-rw-r--r--	2026-01-13 09:57
perltw.pod	5.15 KB	-rw-r--r--	2026-01-13 09:57
perlunicode.pod	70.89 KB	-rw-r--r--	2026-01-13 09:57
perlunifaq.pod	13.31 KB	-rw-r--r--	2026-01-13 09:57
perluniintro.pod	35.44 KB	-rw-r--r--	2026-01-13 09:57
perluniprops.pod	229.74 KB	-rw-r--r--	2026-01-13 09:57
perlunitut.pod	7.76 KB	-rw-r--r--	2026-01-13 09:57
perlutil.pod	9.68 KB	-rw-r--r--	2026-01-13 09:57
perluts.pod	3.11 KB	-rw-r--r--	2026-01-13 09:57
perlvar.pod	69.19 KB	-rw-r--r--	2026-01-13 09:57
perlvmesa.pod	3.88 KB	-rw-r--r--	2026-01-13 09:57
perlvms.pod	51.33 KB	-rw-r--r--	2026-01-13 09:57
perlvos.pod	5.82 KB	-rw-r--r--	2026-01-13 09:57
perlwin32.pod	34.58 KB	-rw-r--r--	2026-01-13 09:57
perlxs.pod	71.66 KB	-rw-r--r--	2026-01-13 09:57
perlxstut.pod	48.52 KB	-rw-r--r--	2026-01-13 09:57
perlxstypemap.pod	22.97 KB	-rw-r--r--	2026-01-13 09:57

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<mro/mro.xs>, and C<S_mro_get_linear_isa_dfs()>
in F<mro.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