Perl Diver 2.31
Main Environment Variables Perl Default Values Perl Config - Summary Perl Config - Full Installed Modules List Directory uptime Docs

Module Documentation
Details and documentation about a specific module, including version and documentation (if available). Note that while links to perldoc.com and search.cpan.org are provided, the module may be part of a larger distribution. If you reach a File Not Found page on either site, please try the parent module.

Class::MOP::Package

Name Class::MOP::Package
Version 2.2201
Located at /usr/local/lib64/perl5
File /usr/local/lib64/perl5/Class/MOP/Package.pm
Is Core No
Search CPAN for this module Class::MOP::Package
Documentation Class::MOP::Package
Module Details Class::MOP::Package


NAME

Class::MOP::Package - Package Meta Object


VERSION

version 2.2201


DESCRIPTION

The Package Protocol provides an abstraction of a Perl 5 package. A package is basically namespace, and this module provides methods for looking at and changing that namespace's symbol table.


METHODS

Class::MOP::Package->initialize($package_name, %options)

This method creates a new Class::MOP::Package instance which represents specified package. If an existing metaclass object exists for the package, that will be returned instead. No options are valid at the package level.

Class::MOP::Package->reinitialize($package, %options)

This method forcibly removes any existing metaclass for the package before calling initialize. In contrast to initialize, you may also pass an existing Class::MOP::Package instance instead of just a package name as $package.

Do not call this unless you know what you are doing.

Class::MOP::Package->create($package, %options)

Creates a new Class::MOP::Package instance which represents the specified package, and also does some initialization of that package. Currently, this just does the same thing as initialize, but is overridden in subclasses, such as Class::MOP::Class.

Class::MOP::Package->create_anon(%options)

Creates a new anonymous package. Valid keys for %options are:

cache
If this will be true (the default is false), the instance will be cached in Class::MOP's metaclass cache.

weaken
If this is true (the default true when cache is false), the instance stored in Class::MOP's metaclass cache will be weakened, so that the anonymous package will be garbage collected when the returned instance goes out of scope.

$metapackage->is_anon

Returns true if the package is an anonymous package.

$metapackage->name

This is returns the package's name, as passed to the constructor.

$metapackage->namespace

This returns a hash reference to the package's symbol table. The keys are symbol names and the values are typeglob references.

$metapackage->add_package_symbol($variable_name, $initial_value)

This method accepts a variable name and an optional initial value. The $variable_name must contain a leading sigil.

This method creates the variable in the package's symbol table, and sets it to the initial value if one was provided.

$metapackage->get_package_symbol($variable_name)

Given a variable name, this method returns the variable as a reference or undef if it does not exist. The $variable_name must contain a leading sigil.

$metapackage->get_or_add_package_symbol($variable_name)

Given a variable name, this method returns the variable as a reference. If it does not exist, a default value will be generated if possible. The $variable_name must contain a leading sigil.

$metapackage->has_package_symbol($variable_name)

Returns true if there is a package variable defined for $variable_name. The $variable_name must contain a leading sigil.

$metapackage->remove_package_symbol($variable_name)

This will remove the package variable specified $variable_name. The $variable_name must contain a leading sigil.

$metapackage->remove_package_glob($glob_name)

Given the name of a glob, this will remove that glob from the package's symbol table. Glob names do not include a sigil. Removing the glob removes all variables and subroutines with the specified name.

$metapackage->list_all_package_symbols($type_filter)

This will list all the glob names associated with the current package. These names do not have leading sigils.

You can provide an optional type filter, which should be one of 'SCALAR', 'ARRAY', 'HASH', or 'CODE'.

$metapackage->get_all_package_symbols($type_filter)

This works much like list_all_package_symbols, but it returns a hash reference. The keys are glob names and the values are references to the value for that name.

Class::MOP::Package->meta

This will return a the Class::MOP::Class manpage instance for this class.


AUTHORS


COPYRIGHT AND LICENSE

This software is copyright (c) 2006 by Infinity Interactive, Inc.

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

Perl Diver brought to you by ScriptSolutions.com © 1997- 2024