藤 吾郎 > Devel-MRO > Devel::MRO

Download:
Devel-MRO-0.05.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.05   Source  

NAME ^

Devel::MRO - Provides mro functions for XS modules

VERSION ^

This document describes Devel::MRO version 0.05.

SYNOPSIS ^

        # In your XS distribution

        # Add the following to your Makefile.PL
        use inc::Module::Install;
        use ExtUtils::Depends;
        # ...
        requires 'MRO::Compat' if $] < 5.010_000;

        include 'ExtUtils::Depends';
        my $pkg = ExtUtils::Depends->new('Your::Module', 'Devel::MRO');
        # ...

        WriteMakefile(
                $pkg->get_makefile_vars,
                # ...
        );

        /* Then put the "include" directive in your Module.xs */

        /* ... */
        #include "ppport.h"

        #define NEED_mro_get_linear_isa /* or NEED_mro_get_linear_isa_GLOBAL */
        #include "mro_compat.h"

        /* Now you can use several mro functions in your Module.xs:
                mro_get_linear_isa()
                mro_get_pkg_gen()
                mro_method_changed_in()
        */

DESCRIPTION ^

Devel::MRO provides several mro functions for XS modules.

This module provides only a header file, mro_compat.h, so you need not load it in your modules.

XS interface ^

AV* mro_get_linear_isa(HV* stash)

The same as mro::get_linear_isa() in Perl.

In 5.10 or later, it is just a public Perl API.

In pre-5.10 it calls mro::get_linear_isa provided by MRO::Compat. It has a cache mechanism as Perl 5.10 does, so it is much faster than the direct call of MRO::Compat's mro::get_linear_isa.

void mro_method_changed_in(HV* stash)

The same as mro::method_changed_in() in Perl.

U32 mro_get_pkg_gen(HV* stash)

The same as mro::get_pkg_gen() in Perl. This is not a Perl API.

This may evaluate stash more than once.

DEPENDENCIES ^

Perl 5.8.1 or later.

ExtUtils::Depends.

MRO::Compat if Perl version < 5.10.0.

BUGS ^

No bugs have been reported.

Please report any bugs or feature requests to the author.

AUTHOR ^

Goro Fuji(gfx) <gfuji(at)cpan.org>.

SEE ALSO ^

mro.

MRO::Compat.

"MRO Functions" in perlapi.

LICENSE AND COPYRIGHT ^

Copyright (c) 2008-2009, Goro Fuji (gfx). Some rights reserved.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

syntax highlighting: