Gecko [ armaneco.co.uk ]

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

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