phpman > man > parent(3perl)

NAME
    parent - Establish an ISA relationship with base classes at compile time

SYNOPSIS
        package Baz;
        use parent qw(Foo Bar);

DESCRIPTION
    Allows you to both load one or more modules, while setting up inheritance from those modules at
    the same time. Mostly similar in effect to

        package Baz;
        BEGIN {
            require Foo;
            require Bar;
            push @ISA, qw(Foo Bar);
        }

    By default, every base class needs to live in a file of its own. If you want to have a subclass
    and its parent class in the same file, you can tell "parent" not to load any modules by using
    the "-norequire" switch:

      package Foo;
      sub exclaim { "I CAN HAS PERL" }

      package DoesNotLoadFooBar;
      use parent -norequire, 'Foo', 'Bar';
      # will not go looking for Foo.pm or Bar.pm

    This is equivalent to the following code:

      package Foo;
      sub exclaim { "I CAN HAS PERL" }

      package DoesNotLoadFooBar;
      push @DoesNotLoadFooBar::ISA, 'Foo', 'Bar';

    This is also helpful for the case where a package lives within a differently named file:

      package MyHash;
      use Tie::Hash;
      use parent -norequire, 'Tie::StdHash';

    This is equivalent to the following code:

      package MyHash;
      require Tie::Hash;
      push @ISA, 'Tie::StdHash';

    If you want to load a subclass from a file that "require" would not consider an eligible
    filename (that is, it does not end in either ".pm" or ".pmc"), use the following code:

      package MySecondPlugin;
      require './plugins/custom.plugin'; # contains Plugin::Custom
      use parent -norequire, 'Plugin::Custom';

HISTORY
    This module was forked from base to remove the cruft that had accumulated in it.

CAVEATS
SEE ALSO
    base
    parent::versioned
        A fork of parent that provides version checking in parent class modules.

AUTHORS AND CONTRIBUTORS
    Rafaël Garcia-Suarez, Bart Lateur, Max Maischein, Anno Siegel, Michael Schwern

MAINTAINER
    Max Maischein " corion AT cpan.org "

    Copyright (c) 2007-2017 Max Maischein "<corion AT cpan.org>" Based on the idea of "base.pm", which
    was introduced with Perl 5.004_04.

LICENSE
    This module is released under the same terms as Perl itself.