parent(3perl) - phpMan

parent(3perl)                    Perl Programmers Reference Guide                   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
       Rafael 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.

perl v5.34.0                                2025-07-25                              parent(3perl)

Generated by $Id: phpMan.php,v 4.55 2007/09/05 04:42:51 chedong Exp $ Author: Che Dong
On Apache
Under GNU General Public License
2026-01-10 12:09 @216.73.216.127 CrawledBy Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)