```{index} single: meta (pragma) ``` # meta ```{pperl-module-badges} meta ``` Meta-programming without symbolic references: objects for packages (`meta::package`), globs (`meta::glob`), variables (`meta::variable`), subroutines (`meta::subroutine`) and their signatures (`meta::subsignature`), with methods to look into them and change them - add and remove symbols, name a sub, set its prototype, read a signature's parameters. Every function warns in the `meta::experimental` category. This is a native implementation of meta 0.015's `meta.xs`; its `meta.pm` is used unchanged. ## Synopsis ```perl use meta; no warnings 'meta::experimental'; my $pkg = meta::package->get("My::Class"); $pkg->add_symbol('&hello' => sub { "hello" }); print My::Class->hello, "\n"; my $sub = meta::package->get("main")->get_symbol('&handler'); print $sub->subname, "\n"; # main::handler ``` Each object is a reference to the address of what it describes, blessed into its class, as meta.xs makes them. ## Modules - [`meta::glob`](meta/glob) - [`meta::package`](meta/package) - [`meta::subroutine`](meta/subroutine) - [`meta::subsignature`](meta/subsignature) - [`meta::symbol`](meta/symbol) - [`meta::variable`](meta/variable) ## Functions ### Packages #### `get_package` `meta::get_package($name)`: the package `$name`, created if it does not exist. #### `get_this_package` `meta::get_this_package()`: the package of the code that calls it. ### Symbols #### `for_reference` `meta::for_reference($ref)`: the glob, subroutine or variable `$ref` refers to; a non-reference croaks. ```{toctree} :hidden: :maxdepth: 1 meta/glob meta/package meta/subroutine meta/subsignature meta/symbol meta/variable ```