Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
parent(3)	      User Contributed Perl Documentation	     parent(3)

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
       Rafal Garcia-Suarez, Bart Lateur, Max Maischein,	Anno Siegel, Michael
       Schwern

MAINTAINER
       Max Maischein " corion@cpan.org "

       Copyright (c) 2007-2017 Max Maischein "<corion@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.42.0			  2024-12-13			     parent(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=parent&sektion=3&manpath=FreeBSD+Ports+15.0.quarterly>

home | help