---
name: "Test2::Util::Stash"
section: "3pm"
platform: "linux"
package: "libtest-simple-perl"
version: "1.302210-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Test2::Util::Stash/3pm"
---

# Test2::Util::Stash(3pm)

Utilities for manipulating stashes and globs.

## NAME

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:

  ```
      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 \<exodist@cpan.org\>

  ## AUTHORS

- Chad Granum \<exodist@cpan.org\>

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