---
name: "UNIVERSAL::exports"
section: "3pm"
platform: "linux"
package: "libuniversal-exports-perl"
version: "0.05-5"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/UNIVERSAL::exports"
---

# UNIVERSAL::exports(3pm)

Lightweight, universal exporting of variables

## 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\>

## BUGS and ISSUES

Please report bugs and issues via \<http://rt.cpan.org\>

## LICENSE and COPYRIGHT

Copyright 2001, 2006 Michael G Schwern

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

See \<http://www.perl.com/perl/misc/Artistic.html\>

## SEE ALSO

Other ways to Export: Exporter, Exporter::Lite, Sub::Exporter, Exporter::Simple

The Perl 6 RFC that started it all:  \<http://dev.perl.org/rfc/257.pod\>

More UNIVERSAL magic:  UNIVERSAL::require