```{index} single: Test2::Util::Stash ``` # Test2::Util::Stash Utilities for manipulating stashes and globs. ## DESCRIPTION This is a collection of utilities for manipulating and inspecting package stashes and globs. ## EXPORTS - $stash = get\_stash($package) Gets the package stash. This is the same as `$stash = \%Package::Name::`. - $sym\_spec = parse\_symbol($symbol) - $sym\_spec = parse\_symbol($symbol, $package) Parse a symbol name, and return a hashref with info about the symbol. `$symbol` can be a simple name, or a fully qualified symbol name. The sigil is optional, and `&` is assumed if none is provided. If `$symbol` is fully qualified, and `$package` is also provided, then the package of the symbol must match the `$package`. Returns a structure like this: ```perl return { name => 'BAZ', sigil => '$', type => 'SCALAR', symbol => '&Foo::Bar::BAZ', package => 'Foo::Bar', }; ``` - $glob\_ref = get\_glob($symbol) - $glob\_ref = get\_glob($symbol, $package) Get a glob ref. Arguments are the same as for `parse_symbol`. - $ref = get\_symbol($symbol) - $ref = get\_symbol($symbol, $package) Get a reference to the symbol. Arguments are the same as for `parse_symbol`. - $ref = purge\_symbol($symbol) - $ref = purge\_symbol($symbol, $package) Completely remove the symbol from the package symbol table. Arguments are the same as for `parse_symbol`. A reference to the removed symbol is returned. - $sig = slot\_to\_sig($slot) Convert a slot (like 'SCALAR') to a sigil (like '$'). - $slot = sig\_to\_slot($sig) Convert a sigil (like '$') to a slot (like 'SCALAR'). ## SOURCE The source code repository for Test2-Suite can be found at `https://github.com/Test-More/test-more/`. ## MAINTAINERS - Chad Granum ## AUTHORS - Chad Granum ## COPYRIGHT Copyright Chad Granum . This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See `http://dev.perl.org/licenses/`