Test2::Util::Stash(3pm) Perl Programmers Reference Guide Test2::Util::Stash(3pm)

# [NAME](#NAME)

Test2::Util::Stash - Utilities for manipulating stashes and globs.

# [DESCRIPTION](#DESCRIPTION)

This is a collection of utilities for manipulating and inspecting package stashes and globs.

# [EXPORTS](#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:

```
    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](#SOURCE)

The source code repository for Test2-Suite can be found at *https://github.com/Test-More/test-more/*.

# [MAINTAINERS](#MAINTAINERS)

[Chad Granum <exodist@cpan.org>](#Chad)

# [AUTHORS](#AUTHORS)

[Chad Granum <exodist@cpan.org>](#Chad~2)

# [COPYRIGHT](#COPYRIGHT)

Copyright Chad Granum <exodist@cpan.org>.

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/*

2026-10-27 perl v5.44.0

---

Document: Test2::Util::Stash(3pm) from perl 5.44.0-r4 (Chainguard OS)
Source: https://github.com/Perl/perl5.git