Gecko [ 37julay.space ]

Name	Size	Permission	Date
perl.pod	15.89 KB	-rw-r--r--	2025-07-28 08:07
perl5004delta.pod	54.92 KB	-rw-r--r--	2025-07-28 08:07
perl5005delta.pod	33.48 KB	-rw-r--r--	2025-07-28 08:07
perl5100delta.pod	54.23 KB	-rw-r--r--	2025-07-28 08:07
perl5101delta.pod	42.86 KB	-rw-r--r--	2025-07-28 08:07
perl5120delta.pod	87.18 KB	-rw-r--r--	2025-07-28 08:07
perl5121delta.pod	9.9 KB	-rw-r--r--	2025-07-28 08:07
perl5122delta.pod	9.38 KB	-rw-r--r--	2025-07-28 08:07
perl5123delta.pod	4 KB	-rw-r--r--	2025-07-28 08:07
perl5124delta.pod	3.59 KB	-rw-r--r--	2025-07-28 08:07
perl5125delta.pod	7.5 KB	-rw-r--r--	2025-07-28 08:07
perl5140delta.pod	140.94 KB	-rw-r--r--	2025-07-28 08:07
perl5141delta.pod	7.78 KB	-rw-r--r--	2025-07-28 08:07
perl5142delta.pod	6.73 KB	-rw-r--r--	2025-07-28 08:07
perl5143delta.pod	7.58 KB	-rw-r--r--	2025-07-28 08:07
perl5144delta.pod	6.18 KB	-rw-r--r--	2025-07-28 08:07
perl5160delta.pod	130.52 KB	-rw-r--r--	2025-07-28 08:07
perl5161delta.pod	6 KB	-rw-r--r--	2025-07-28 08:07
perl5162delta.pod	3.51 KB	-rw-r--r--	2025-07-28 08:07
perl5163delta.pod	3.99 KB	-rw-r--r--	2025-07-28 08:07
perl5180delta.pod	116.63 KB	-rw-r--r--	2025-07-28 08:07
perl5181delta.pod	6.44 KB	-rw-r--r--	2025-07-28 08:07
perl5182delta.pod	5.21 KB	-rw-r--r--	2025-07-28 08:07
perl5184delta.pod	4.53 KB	-rw-r--r--	2025-07-28 08:07
perl5200delta.pod	112.99 KB	-rw-r--r--	2025-07-28 08:07
perl5201delta.pod	10.64 KB	-rw-r--r--	2025-07-28 08:07
perl5202delta.pod	12.22 KB	-rw-r--r--	2025-07-28 08:07
perl5203delta.pod	9.17 KB	-rw-r--r--	2025-07-28 08:07
perl5220delta.pod	127.89 KB	-rw-r--r--	2025-07-28 08:07
perl5221delta.pod	10.51 KB	-rw-r--r--	2025-07-28 08:07
perl5222delta.pod	12.33 KB	-rw-r--r--	2025-07-28 08:07
perl5223delta.pod	8.26 KB	-rw-r--r--	2025-07-28 08:07
perl5224delta.pod	4.36 KB	-rw-r--r--	2025-07-28 08:07
perl5240delta.pod	63.41 KB	-rw-r--r--	2025-07-28 08:07
perl5241delta.pod	8.02 KB	-rw-r--r--	2025-07-28 08:07
perl5242delta.pod	4.02 KB	-rw-r--r--	2025-07-28 08:07
perl5243delta.pod	11.16 KB	-rw-r--r--	2025-07-28 08:07
perl5244delta.pod	4.4 KB	-rw-r--r--	2025-07-28 08:07
perl5260delta.pod	99.45 KB	-rw-r--r--	2025-07-28 08:07
perl5261delta.pod	7.74 KB	-rw-r--r--	2025-07-28 08:07
perl5262delta.pod	7.7 KB	-rw-r--r--	2025-07-28 08:07
perl5263delta.pod	6.9 KB	-rw-r--r--	2025-07-28 08:07
perl5280delta.pod	70.42 KB	-rw-r--r--	2025-07-28 08:07
perl561delta.pod	121.79 KB	-rw-r--r--	2025-07-28 08:07
perl56delta.pod	104.69 KB	-rw-r--r--	2025-07-28 08:07
perl581delta.pod	37.17 KB	-rw-r--r--	2025-07-28 08:07
perl582delta.pod	4.37 KB	-rw-r--r--	2025-07-28 08:07
perl583delta.pod	6.19 KB	-rw-r--r--	2025-07-28 08:07
perl584delta.pod	7.19 KB	-rw-r--r--	2025-07-28 08:07
perl585delta.pod	5.75 KB	-rw-r--r--	2025-07-28 08:07
perl586delta.pod	4.54 KB	-rw-r--r--	2025-07-28 08:07
perl587delta.pod	8.16 KB	-rw-r--r--	2025-07-28 08:07
perl588delta.pod	24.68 KB	-rw-r--r--	2025-07-28 08:07
perl589delta.pod	52.64 KB	-rw-r--r--	2025-07-28 08:07
perl58delta.pod	112.47 KB	-rw-r--r--	2025-07-28 08:07
perlaix.pod	19.96 KB	-rw-r--r--	2025-07-28 08:07
perlamiga.pod	5.61 KB	-rw-r--r--	2025-07-28 08:07
perlandroid.pod	7.69 KB	-rw-r--r--	2025-07-28 08:07
perlapi.pod	433.14 KB	-rw-r--r--	2025-07-28 08:07
perlapio.pod	18.83 KB	-rw-r--r--	2025-07-28 08:07
perlartistic.pod	6.85 KB	-rw-r--r--	2025-07-28 08:07
perlbook.pod	8.14 KB	-rw-r--r--	2025-07-28 08:07
perlboot.pod	294 B	-rw-r--r--	2025-07-28 08:07
perlbot.pod	304 B	-rw-r--r--	2025-07-28 08:07
perlbs2000.pod	7.87 KB	-rw-r--r--	2025-07-28 08:07
perlcall.pod	55.38 KB	-rw-r--r--	2025-07-28 08:07
perlce.pod	14.26 KB	-rw-r--r--	2025-07-28 08:07
perlcheat.pod	4.38 KB	-rw-r--r--	2025-07-28 08:07
perlclib.pod	9.39 KB	-rw-r--r--	2025-07-28 08:07
perlcn.pod	4.58 KB	-rw-r--r--	2025-07-28 08:07
perlcommunity.pod	7.05 KB	-rw-r--r--	2025-07-28 08:07
perlcygwin.pod	26.56 KB	-rw-r--r--	2025-07-28 08:07
perldata.pod	45.65 KB	-rw-r--r--	2025-07-28 08:07
perldbmfilter.pod	4.86 KB	-rw-r--r--	2025-07-28 08:07
perldebguts.pod	37.63 KB	-rw-r--r--	2025-07-28 08:07
perldebtut.pod	21.63 KB	-rw-r--r--	2025-07-28 08:07
perldebug.pod	38.34 KB	-rw-r--r--	2025-07-28 08:07
perldelta.pod	6.9 KB	-rw-r--r--	2025-07-28 08:07
perldeprecation.pod	17.74 KB	-rw-r--r--	2025-07-28 08:07
perldiag.pod	277.9 KB	-rw-r--r--	2025-07-28 08:07
perldos.pod	10.28 KB	-rw-r--r--	2025-07-28 08:07
perldsc.pod	25.01 KB	-rw-r--r--	2025-07-28 08:07
perldtrace.pod	7.77 KB	-rw-r--r--	2025-07-28 08:07
perlebcdic.pod	82.26 KB	-rw-r--r--	2025-07-28 08:07
perlembed.pod	36.32 KB	-rw-r--r--	2025-07-28 08:07
perlexperiment.pod	7.03 KB	-rw-r--r--	2025-07-28 08:07
perlfork.pod	13.04 KB	-rw-r--r--	2025-07-28 08:07
perlform.pod	16.22 KB	-rw-r--r--	2025-07-28 08:07
perlfreebsd.pod	1.57 KB	-rw-r--r--	2025-07-28 08:07
perlfunc.pod	383.75 KB	-rw-r--r--	2025-07-28 08:07
perlgit.pod	32.72 KB	-rw-r--r--	2025-07-28 08:07
perlgpl.pod	13.49 KB	-rw-r--r--	2025-07-28 08:07
perlguts.pod	136.06 KB	-rw-r--r--	2025-07-28 08:07
perlhack.pod	39.5 KB	-rw-r--r--	2025-07-28 08:07
perlhacktips.pod	54.21 KB	-rw-r--r--	2025-07-28 08:07
perlhacktut.pod	6.01 KB	-rw-r--r--	2025-07-28 08:07
perlhaiku.pod	1.47 KB	-rw-r--r--	2025-07-28 08:07
perlhist.pod	52.29 KB	-rw-r--r--	2025-07-28 08:07
perlhpux.pod	29.79 KB	-rw-r--r--	2025-07-28 08:07
perlhurd.pod	1.95 KB	-rw-r--r--	2025-07-28 08:07
perlintern.pod	53.29 KB	-rw-r--r--	2025-07-28 08:07
perlinterp.pod	32.9 KB	-rw-r--r--	2025-07-28 08:07
perlintro.pod	21.6 KB	-rw-r--r--	2025-07-28 08:07
perliol.pod	33.38 KB	-rw-r--r--	2025-07-28 08:07
perlipc.pod	69.17 KB	-rw-r--r--	2025-07-28 08:07
perlirix.pod	4.29 KB	-rw-r--r--	2025-07-28 08:07
perljp.pod	7.34 KB	-rw-r--r--	2025-07-28 08:07
perlko.pod	11.97 KB	-rw-r--r--	2025-07-28 08:07
perllexwarn.pod	355 B	-rw-r--r--	2025-07-28 08:07
perllinux.pod	1.45 KB	-rw-r--r--	2025-07-28 08:07
perllocale.pod	67.07 KB	-rw-r--r--	2025-07-28 08:07
perllol.pod	9.36 KB	-rw-r--r--	2025-07-28 08:07
perlmacos.pod	1001 B	-rw-r--r--	2025-07-28 08:07
perlmacosx.pod	11.78 KB	-rw-r--r--	2025-07-28 08:07
perlmod.pod	25.63 KB	-rw-r--r--	2025-07-28 08:07
perlmodinstall.pod	12.49 KB	-rw-r--r--	2025-07-28 08:07
perlmodlib.pod	74.69 KB	-rw-r--r--	2025-07-28 08:07
perlmodstyle.pod	22.05 KB	-rw-r--r--	2025-07-28 08:07
perlmroapi.pod	3.14 KB	-rw-r--r--	2025-07-28 08:07
perlnetware.pod	6.49 KB	-rw-r--r--	2025-07-28 08:07
perlnewmod.pod	10.78 KB	-rw-r--r--	2025-07-28 08:07
perlnumber.pod	8.16 KB	-rw-r--r--	2025-07-28 08:07
perlobj.pod	34.7 KB	-rw-r--r--	2025-07-28 08:07
perlootut.pod	26.16 KB	-rw-r--r--	2025-07-28 08:07
perlop.pod	133.06 KB	-rw-r--r--	2025-07-28 08:07
perlopenbsd.pod	1.18 KB	-rw-r--r--	2025-07-28 08:07
perlopentut.pod	9.23 KB	-rw-r--r--	2025-07-28 08:07
perlos2.pod	91.16 KB	-rw-r--r--	2025-07-28 08:07
perlos390.pod	15.31 KB	-rw-r--r--	2025-07-28 08:07
perlos400.pod	4.66 KB	-rw-r--r--	2025-07-28 08:07
perlpacktut.pod	50.08 KB	-rw-r--r--	2025-07-28 08:07
perlperf.pod	48.71 KB	-rw-r--r--	2025-07-28 08:07
perlplan9.pod	5 KB	-rw-r--r--	2025-07-28 08:07
perlpod.pod	21.68 KB	-rw-r--r--	2025-07-28 08:07
perlpodspec.pod	66.87 KB	-rw-r--r--	2025-07-28 08:07
perlpolicy.pod	25.03 KB	-rw-r--r--	2025-07-28 08:07
perlport.pod	85.55 KB	-rw-r--r--	2025-07-28 08:07
perlpragma.pod	5.05 KB	-rw-r--r--	2025-07-28 08:07
perlqnx.pod	6.52 KB	-rw-r--r--	2025-07-28 08:07
perlre.pod	118.07 KB	-rw-r--r--	2025-07-28 08:07
perlreapi.pod	29.62 KB	-rw-r--r--	2025-07-28 08:07
perlrebackslash.pod	31.07 KB	-rw-r--r--	2025-07-28 08:07
perlrecharclass.pod	47.88 KB	-rw-r--r--	2025-07-28 08:07
perlref.pod	34.48 KB	-rw-r--r--	2025-07-28 08:07
perlreftut.pod	18.35 KB	-rw-r--r--	2025-07-28 08:07
perlreguts.pod	37.43 KB	-rw-r--r--	2025-07-28 08:07
perlrepository.pod	509 B	-rw-r--r--	2025-07-28 08:07
perlrequick.pod	18.06 KB	-rw-r--r--	2025-07-28 08:07
perlreref.pod	14.4 KB	-rw-r--r--	2025-07-28 08:07
perlretut.pod	118.42 KB	-rw-r--r--	2025-07-28 08:07
perlriscos.pod	1.49 KB	-rw-r--r--	2025-07-28 08:07
perlrun.pod	52.29 KB	-rw-r--r--	2025-07-28 08:07
perlsec.pod	25.57 KB	-rw-r--r--	2025-07-28 08:07
perlsolaris.pod	29.12 KB	-rw-r--r--	2025-07-28 08:07
perlsource.pod	6.71 KB	-rw-r--r--	2025-07-28 08:07
perlstyle.pod	8.43 KB	-rw-r--r--	2025-07-28 08:07
perlsub.pod	71.26 KB	-rw-r--r--	2025-07-28 08:07
perlsymbian.pod	15 KB	-rw-r--r--	2025-07-28 08:07
perlsyn.pod	43.47 KB	-rw-r--r--	2025-07-28 08:07
perlsynology.pod	7.6 KB	-rw-r--r--	2025-07-28 08:07
perlthrtut.pod	45.37 KB	-rw-r--r--	2025-07-28 08:07
perltie.pod	37.7 KB	-rw-r--r--	2025-07-28 08:07
perltoc.pod	677.9 KB	-rw-r--r--	2025-07-28 08:07
perltodo.pod	376 B	-rw-r--r--	2025-07-28 08:07
perltooc.pod	294 B	-rw-r--r--	2025-07-28 08:07
perltoot.pod	294 B	-rw-r--r--	2025-07-28 08:07
perltrap.pod	10.37 KB	-rw-r--r--	2025-07-28 08:07
perltru64.pod	8.29 KB	-rw-r--r--	2025-07-28 08:07
perltw.pod	4.37 KB	-rw-r--r--	2025-07-28 08:07
perlunicode.pod	80.56 KB	-rw-r--r--	2025-07-28 08:07
perlunicook.pod	24.89 KB	-rw-r--r--	2025-07-28 08:07
perlunifaq.pod	13.33 KB	-rw-r--r--	2025-07-28 08:07
perluniintro.pod	37.44 KB	-rw-r--r--	2025-07-28 08:07
perluniprops.pod	278.62 KB	-rw-r--r--	2025-07-28 08:07
perlunitut.pod	7.76 KB	-rw-r--r--	2025-07-28 08:07
perlutil.pod	7.46 KB	-rw-r--r--	2025-07-28 08:08
perlvar.pod	76.53 KB	-rw-r--r--	2025-07-28 08:07
perlvms.pod	49.63 KB	-rw-r--r--	2025-07-28 08:07
perlvos.pod	3.75 KB	-rw-r--r--	2025-07-28 08:07
perlwin32.pod	38.38 KB	-rw-r--r--	2025-07-28 08:07
perlxs.pod	77.07 KB	-rw-r--r--	2025-07-28 08:07
perlxstut.pod	48.92 KB	-rw-r--r--	2025-07-28 08:07
perlxstypemap.pod	23.44 KB	-rw-r--r--	2025-07-28 08:07

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