NAME

UNIVERSAL::exports - Lightweight, universal exporting of variables

SYNOPSIS

package Foo;
use UNIVERSAL::exports;

# Just like Exporter.
@EXPORT       = qw($This &That);
@EXPORT_OK    = qw(@Left %Right);


# Meanwhile, in another piece of code!
package Bar;
use Foo;  # exports $This and &That.

DESCRIPTION

This is an alternative to Exporter intended to provide a universal, lightweight subset of its functionality. It uses Exporter::Lite, so look there for details.

Additionally, exports() is provided to find out what symbols a module exports.

UNIVERSAL::exports places its methods in the UNIVERSAL namespace, so there is no need to subclass from it.

Methods

UNIVERSAL::exports has two public methods, import() derived from Exporter::Lite, and exports().

import

Some::Module->import;
Some::Module->import(@symbols);

This is Exporter::Lite's import() method. Look in Exporter::Lite for details.

exports

@exported_symbols = Some::Module->exports;
Some::Module->exports($symbol);

Reports what symbols are exported by Some::Module. With no arguments, it simply returns a list of all exportable symbols. Otherwise, it reports if it will export a given $symbol.

DIAGNOSTICS

'"%s" is not exported by the %s module'

Attempted to import a symbol which is not in @EXPORT or @EXPORT_OK.

'Can\'t export symbol: %s'

Attempted to import a symbol of an unknown type (ie. the leading $@% salad wasn't recognized).

AUTHORS

Michael G Schwern <schwern@pobox.com>

SEE ALSO

Exporter, UNIVERSAL::require, http://dev.perl.org/rfc/257.pod