Exporter/lib/Exporter.pm

1 package Exporter;
13   require Exporter::Heavy;
18   \&{"Exporter::Heavy::heavy_$c"};
29   if ($pkg eq "Exporter" and @_ and $_[0] eq "import") {
98 Exporter - Implements default import method for modules
105   use Exporter 'import';
111   require Exporter;
112   our @ISA = qw(Exporter);  # inherit all of Exporter's methods
118   use parent 'Exporter';  # inherit all of Exporter's methods
131 The Exporter module implements an C<import> method which allows a module
133 use Exporter rather than implementing their own C<import> method because
134 Exporter provides a highly flexible interface, with an implementation optimised
141 understanding the Exporter.
210 occurs.  The advanced export features of Exporter are accessed like this,
216 need to know to use Exporter.
260 You can say C<BEGIN { $Exporter::Verbose=1 }> to see how the
264 =head2 Exporting Without Using Exporter's import Method
266 Exporter has a special method, 'export_to_level' which is used in situations
267 where you can't directly call Exporter's
285     our @ISA = qw(Exporter);
294 package A.  Since Exporter relies on the import method to work, via
295 inheritance, as it stands Exporter::import() will never get called.
299     our @ISA = qw(Exporter);
314 =head2 Exporting Without Inheriting from Exporter
316 By including Exporter in your C<@ISA> you inherit an Exporter's import() method
321   use Exporter qw(import);
323 which will export Exporter's own import() method into YourModule.
324 Everything will work as before but you won't need to include Exporter in
328 of Exporter, released with perl 5.8.3.
332 The Exporter module will convert an attempt to import a number from a
337 For historical reasons, Exporter supplies a C<require_version> method that
339 existed, Exporter would call C<require_version>.
355 If a module attempts to import any of these symbols the Exporter
357 generating an error.  The Exporter will call an export_fail method
365 export fails.  The Exporter provides a default C<export_fail> method which
382   Exporter::export_tags('foo');     # add aa, bb and cc to @EXPORT
383   Exporter::export_ok_tags('bar');  # add aa, cc and dd to @EXPORT_OK
459 When using C<Exporter> with the standard C<strict> and C<warnings>
463   our @ISA = qw(Exporter);
470   @ISA = qw(Exporter);
476 like C<require Exporter> and the assignment to package
491   use Exporter 'import';
496 Or if you need to inherit from Exporter:
504     require Exporter;
505     our @ISA = qw(Exporter);  # inherit all of Exporter's methods
509 The C<BEGIN> will assure that the loading of F<Exporter.pm>
514 With respect to loading C<Exporter> and inheriting, there
517   use base qw(Exporter);
519   use parent qw(Exporter);
522 C<BEGIN { require Exporter; our @ISA = qw(Exporter); }>
532 vs. compile-time trap is to use L<Exporter::Easy>,
533 which is a wrapper of Exporter that allows all
537    use Exporter::Easy (
567 export variable names.  Just because C<Exporter> lets you
583 C<Exporter> is definitely not the only module with
590     Exporter::Easy
591     Exporter::Lite
592     Exporter::Renaming
593     Exporter::Tidy
594     Sub::Exporter / Sub::Installer