Gecko [ www.ap.oishifashion.com ]

Name	Size	Permission	Date
perl.pod	16.28 KB	-rw-r--r--	2024-04-03 14:35
perl5004delta.pod	54.92 KB	-rw-r--r--	2024-04-03 14:39
perl5005delta.pod	33.48 KB	-rw-r--r--	2024-04-03 14:39
perl5100delta.pod	54.23 KB	-rw-r--r--	2024-04-03 14:39
perl5101delta.pod	42.86 KB	-rw-r--r--	2024-04-03 14:39
perl5120delta.pod	87.18 KB	-rw-r--r--	2024-04-03 14:39
perl5121delta.pod	9.9 KB	-rw-r--r--	2024-04-03 14:39
perl5122delta.pod	9.38 KB	-rw-r--r--	2024-04-03 14:39
perl5123delta.pod	4 KB	-rw-r--r--	2024-04-03 14:39
perl5124delta.pod	3.59 KB	-rw-r--r--	2024-04-03 14:39
perl5125delta.pod	7.5 KB	-rw-r--r--	2024-04-03 14:39
perl5140delta.pod	140.94 KB	-rw-r--r--	2024-04-03 14:39
perl5141delta.pod	7.78 KB	-rw-r--r--	2024-04-03 14:39
perl5142delta.pod	6.73 KB	-rw-r--r--	2024-04-03 14:39
perl5143delta.pod	7.58 KB	-rw-r--r--	2024-04-03 14:39
perl5144delta.pod	6.18 KB	-rw-r--r--	2024-04-03 14:39
perl5160delta.pod	130.52 KB	-rw-r--r--	2024-04-03 14:39
perl5161delta.pod	6 KB	-rw-r--r--	2024-04-03 14:39
perl5162delta.pod	3.51 KB	-rw-r--r--	2024-04-03 14:39
perl5163delta.pod	3.99 KB	-rw-r--r--	2024-04-03 14:39
perl5180delta.pod	116.63 KB	-rw-r--r--	2024-04-03 14:39
perl5181delta.pod	6.44 KB	-rw-r--r--	2024-04-03 14:39
perl5182delta.pod	5.21 KB	-rw-r--r--	2024-04-03 14:39
perl5184delta.pod	4.53 KB	-rw-r--r--	2024-04-03 14:39
perl5200delta.pod	112.99 KB	-rw-r--r--	2024-04-03 14:39
perl5201delta.pod	10.64 KB	-rw-r--r--	2024-04-03 14:39
perl5202delta.pod	12.22 KB	-rw-r--r--	2024-04-03 14:39
perl5203delta.pod	9.17 KB	-rw-r--r--	2024-04-03 14:39
perl5220delta.pod	127.89 KB	-rw-r--r--	2024-04-03 14:39
perl5221delta.pod	10.51 KB	-rw-r--r--	2024-04-03 14:39
perl5222delta.pod	12.33 KB	-rw-r--r--	2024-04-03 14:39
perl5223delta.pod	8.26 KB	-rw-r--r--	2024-04-03 14:39
perl5224delta.pod	4.36 KB	-rw-r--r--	2024-04-03 14:39
perl5240delta.pod	63.4 KB	-rw-r--r--	2024-04-03 14:39
perl5241delta.pod	8.02 KB	-rw-r--r--	2024-04-03 14:39
perl5242delta.pod	4.02 KB	-rw-r--r--	2024-04-03 14:39
perl5243delta.pod	11.16 KB	-rw-r--r--	2024-04-03 14:39
perl5244delta.pod	4.4 KB	-rw-r--r--	2024-04-03 14:39
perl5260delta.pod	99.45 KB	-rw-r--r--	2024-04-03 14:39
perl5261delta.pod	7.74 KB	-rw-r--r--	2024-04-03 14:39
perl5262delta.pod	7.7 KB	-rw-r--r--	2024-04-03 14:39
perl5263delta.pod	6.9 KB	-rw-r--r--	2024-04-03 14:39
perl5280delta.pod	70.42 KB	-rw-r--r--	2024-04-03 14:39
perl5281delta.pod	4.53 KB	-rw-r--r--	2024-04-03 14:39
perl5282delta.pod	6.05 KB	-rw-r--r--	2024-04-03 14:39
perl5283delta.pod	4.99 KB	-rw-r--r--	2024-04-03 14:39
perl5300delta.pod	40.31 KB	-rw-r--r--	2024-04-03 14:39
perl5301delta.pod	5.6 KB	-rw-r--r--	2024-04-03 14:39
perl5302delta.pod	4.57 KB	-rw-r--r--	2024-04-03 14:39
perl5303delta.pod	4.86 KB	-rw-r--r--	2024-04-03 14:39
perl5320delta.pod	53.32 KB	-rw-r--r--	2024-04-03 14:39
perl5321delta.pod	6.84 KB	-rw-r--r--	2024-04-03 14:39
perl561delta.pod	121.79 KB	-rw-r--r--	2024-04-03 14:39
perl56delta.pod	104.69 KB	-rw-r--r--	2024-04-03 14:39
perl581delta.pod	37.17 KB	-rw-r--r--	2024-04-03 14:39
perl582delta.pod	4.37 KB	-rw-r--r--	2024-04-03 14:39
perl583delta.pod	6.19 KB	-rw-r--r--	2024-04-03 14:39
perl584delta.pod	7.19 KB	-rw-r--r--	2024-04-03 14:39
perl585delta.pod	5.75 KB	-rw-r--r--	2024-04-03 14:39
perl586delta.pod	4.54 KB	-rw-r--r--	2024-04-03 14:39
perl587delta.pod	8.16 KB	-rw-r--r--	2024-04-03 14:39
perl588delta.pod	24.69 KB	-rw-r--r--	2024-04-03 14:39
perl589delta.pod	52.64 KB	-rw-r--r--	2024-04-03 14:39
perl58delta.pod	112.47 KB	-rw-r--r--	2024-04-03 14:39
perlaix.pod	19.96 KB	-rw-r--r--	2024-04-03 14:39
perlamiga.pod	5.61 KB	-rw-r--r--	2024-04-03 14:39
perlandroid.pod	8.03 KB	-rw-r--r--	2024-04-03 14:39
perlapi.pod	481.55 KB	-rw-r--r--	2024-04-03 14:39
perlapio.pod	20.84 KB	-rw-r--r--	2024-04-03 14:39
perlartistic.pod	6.85 KB	-rw-r--r--	2024-04-03 14:39
perlbook.pod	8.19 KB	-rw-r--r--	2024-04-03 14:39
perlboot.pod	294 B	-rw-r--r--	2024-04-03 14:39
perlbot.pod	304 B	-rw-r--r--	2024-04-03 14:39
perlbs2000.pod	7.81 KB	-rw-r--r--	2024-04-03 14:39
perlcall.pod	55.41 KB	-rw-r--r--	2024-04-03 14:39
perlcheat.pod	4.38 KB	-rw-r--r--	2024-04-03 14:39
perlclib.pod	9.38 KB	-rw-r--r--	2024-04-03 14:39
perlcn.pod	4.65 KB	-rw-r--r--	2024-04-03 14:39
perlcommunity.pod	6.82 KB	-rw-r--r--	2024-04-03 14:39
perlcygwin.pod	26.56 KB	-rw-r--r--	2024-04-03 14:39
perldata.pod	48.62 KB	-rw-r--r--	2024-04-03 14:39
perldbmfilter.pod	4.86 KB	-rw-r--r--	2024-04-03 14:39
perldebguts.pod	41.34 KB	-rw-r--r--	2024-04-03 14:39
perldebtut.pod	21.63 KB	-rw-r--r--	2024-04-03 14:39
perldebug.pod	38.46 KB	-rw-r--r--	2024-04-03 14:39
perldelta.pod	6.84 KB	-rw-r--r--	2024-04-03 14:39
perldeprecation.pod	20.34 KB	-rw-r--r--	2024-04-03 14:39
perldiag.pod	290.03 KB	-rw-r--r--	2024-04-03 14:39
perldos.pod	10.28 KB	-rw-r--r--	2024-04-03 14:39
perldsc.pod	25.01 KB	-rw-r--r--	2024-04-03 14:39
perldtrace.pod	7.77 KB	-rw-r--r--	2024-04-03 14:39
perlebcdic.pod	82.37 KB	-rw-r--r--	2024-04-03 14:39
perlembed.pod	36.69 KB	-rw-r--r--	2024-04-03 14:39
perlexperiment.pod	7.06 KB	-rw-r--r--	2024-04-03 14:39
perlfork.pod	13.04 KB	-rw-r--r--	2024-04-03 14:39
perlform.pod	16.22 KB	-rw-r--r--	2024-04-03 14:39
perlfreebsd.pod	1.58 KB	-rw-r--r--	2024-04-03 14:39
perlfunc.pod	394.31 KB	-rw-r--r--	2024-04-03 14:39
perlgit.pod	28.9 KB	-rw-r--r--	2024-04-03 14:39
perlgov.pod	14.14 KB	-rw-r--r--	2024-04-03 14:39
perlgpl.pod	13.49 KB	-rw-r--r--	2024-04-03 14:39
perlguts.pod	158.3 KB	-rw-r--r--	2024-04-03 14:39
perlhack.pod	42.15 KB	-rw-r--r--	2024-04-03 14:39
perlhacktips.pod	56.34 KB	-rw-r--r--	2024-04-03 14:39
perlhacktut.pod	6.01 KB	-rw-r--r--	2024-04-03 14:39
perlhaiku.pod	1.47 KB	-rw-r--r--	2024-04-03 14:39
perlhist.pod	54.85 KB	-rw-r--r--	2024-04-03 14:39
perlhpux.pod	29.89 KB	-rw-r--r--	2024-04-03 14:39
perlhurd.pod	1.95 KB	-rw-r--r--	2024-04-03 14:39
perlintern.pod	81.61 KB	-rw-r--r--	2024-04-03 14:39
perlinterp.pod	32.92 KB	-rw-r--r--	2024-04-03 14:39
perlintro.pod	21.62 KB	-rw-r--r--	2024-04-03 14:39
perliol.pod	33.99 KB	-rw-r--r--	2024-04-03 14:39
perlipc.pod	69.85 KB	-rw-r--r--	2024-04-03 14:39
perlirix.pod	4.31 KB	-rw-r--r--	2024-04-03 14:39
perljp.pod	8.23 KB	-rw-r--r--	2024-04-03 14:39
perlko.pod	11.92 KB	-rw-r--r--	2024-04-03 14:39
perllexwarn.pod	355 B	-rw-r--r--	2024-04-03 14:39
perllinux.pod	1.96 KB	-rw-r--r--	2024-04-03 14:39
perllocale.pod	72.38 KB	-rw-r--r--	2024-04-03 14:39
perllol.pod	9.36 KB	-rw-r--r--	2024-04-03 14:39
perlmacos.pod	998 B	-rw-r--r--	2024-04-03 14:39
perlmacosx.pod	11.84 KB	-rw-r--r--	2024-04-03 14:39
perlmod.pod	25.58 KB	-rw-r--r--	2024-04-03 14:39
perlmodinstall.pod	10.02 KB	-rw-r--r--	2024-04-03 14:39
perlmodlib.pod	74.56 KB	-rw-r--r--	2024-04-03 14:39
perlmodstyle.pod	22.06 KB	-rw-r--r--	2024-04-03 14:39
perlmroapi.pod	3.2 KB	-rw-r--r--	2024-04-03 14:39
perlnetware.pod	6.49 KB	-rw-r--r--	2024-04-03 14:39
perlnewmod.pod	10.78 KB	-rw-r--r--	2024-04-03 14:39
perlnumber.pod	8.16 KB	-rw-r--r--	2024-04-03 14:39
perlobj.pod	34.88 KB	-rw-r--r--	2024-04-03 14:39
perlootut.pod	26.13 KB	-rw-r--r--	2024-04-03 14:39
perlop.pod	145.4 KB	-rw-r--r--	2024-04-03 14:39
perlopenbsd.pod	1.2 KB	-rw-r--r--	2024-04-03 14:39
perlopentut.pod	14.87 KB	-rw-r--r--	2024-04-03 14:39
perlos2.pod	91.16 KB	-rw-r--r--	2024-04-03 14:39
perlos390.pod	16.14 KB	-rw-r--r--	2024-04-03 14:39
perlos400.pod	4.65 KB	-rw-r--r--	2024-04-03 14:39
perlpacktut.pod	50.17 KB	-rw-r--r--	2024-04-03 14:39
perlperf.pod	48.71 KB	-rw-r--r--	2024-04-03 14:39
perlplan9.pod	5 KB	-rw-r--r--	2024-04-03 14:39
perlpod.pod	22.54 KB	-rw-r--r--	2024-04-03 14:39
perlpodspec.pod	67.02 KB	-rw-r--r--	2024-04-03 14:39
perlpolicy.pod	25.94 KB	-rw-r--r--	2024-04-03 14:39
perlport.pod	86.61 KB	-rw-r--r--	2024-04-03 14:39
perlpragma.pod	5.05 KB	-rw-r--r--	2024-04-03 14:39
perlqnx.pod	6.52 KB	-rw-r--r--	2024-04-03 14:39
perlre.pod	127.75 KB	-rw-r--r--	2024-04-03 14:39
perlreapi.pod	29.54 KB	-rw-r--r--	2024-04-03 14:39
perlrebackslash.pod	31.53 KB	-rw-r--r--	2024-04-03 14:39
perlrecharclass.pod	48.54 KB	-rw-r--r--	2024-04-03 14:39
perlref.pod	34.6 KB	-rw-r--r--	2024-04-03 14:39
perlreftut.pod	18.38 KB	-rw-r--r--	2024-04-03 14:39
perlreguts.pod	38.38 KB	-rw-r--r--	2024-04-03 14:39
perlrepository.pod	509 B	-rw-r--r--	2024-04-03 14:39
perlrequick.pod	18.69 KB	-rw-r--r--	2024-04-03 14:39
perlreref.pod	15.22 KB	-rw-r--r--	2024-04-03 14:39
perlretut.pod	119.66 KB	-rw-r--r--	2024-04-03 14:39
perlriscos.pod	1.49 KB	-rw-r--r--	2024-04-03 14:39
perlrun.pod	54.67 KB	-rw-r--r--	2024-04-03 14:35
perlsec.pod	26.95 KB	-rw-r--r--	2024-04-03 14:39
perlsecpolicy.pod	18.99 KB	-rw-r--r--	2024-04-03 14:39
perlsolaris.pod	29.14 KB	-rw-r--r--	2024-04-03 14:39
perlsource.pod	6.96 KB	-rw-r--r--	2024-04-03 14:39
perlstyle.pod	8.53 KB	-rw-r--r--	2024-04-03 14:39
perlsub.pod	72.66 KB	-rw-r--r--	2024-04-03 14:39
perlsymbian.pod	14.98 KB	-rw-r--r--	2024-04-03 14:39
perlsyn.pod	44.08 KB	-rw-r--r--	2024-04-03 14:39
perlsynology.pod	7.77 KB	-rw-r--r--	2024-04-03 14:39
perlthrtut.pod	45.43 KB	-rw-r--r--	2024-04-03 14:39
perltie.pod	38.39 KB	-rw-r--r--	2024-04-03 14:39
perltoc.pod	685.34 KB	-rw-r--r--	2024-04-03 14:39
perltodo.pod	372 B	-rw-r--r--	2024-04-03 14:39
perltooc.pod	294 B	-rw-r--r--	2024-04-03 14:39
perltoot.pod	294 B	-rw-r--r--	2024-04-03 14:39
perltrap.pod	10.37 KB	-rw-r--r--	2024-04-03 14:39
perltru64.pod	8.29 KB	-rw-r--r--	2024-04-03 14:39
perltw.pod	4.36 KB	-rw-r--r--	2024-04-03 14:39
perlunicode.pod	89.21 KB	-rw-r--r--	2024-04-03 14:39
perlunicook.pod	25.06 KB	-rw-r--r--	2024-04-03 14:39
perlunifaq.pod	13.32 KB	-rw-r--r--	2024-04-03 14:39
perluniintro.pod	37.74 KB	-rw-r--r--	2024-04-03 14:39
perluniprops.pod	431.26 KB	-rw-r--r--	2024-04-03 14:39
perlunitut.pod	7.76 KB	-rw-r--r--	2024-04-03 14:39
perlutil.pod	7.12 KB	-rw-r--r--	2024-04-03 14:39
perlvar.pod	80.64 KB	-rw-r--r--	2024-04-03 14:39
perlvms.pod	49.63 KB	-rw-r--r--	2024-04-03 14:39
perlvos.pod	3.75 KB	-rw-r--r--	2024-04-03 14:39
perlwin32.pod	39.37 KB	-rw-r--r--	2024-04-03 14: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);

=for apidoc mro_get_private_data

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

Perl_mro_set_private_data(aTHX_ meta, &c3_alg, private_sv);

=for apidoc mro_set_private_data

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