---
name: "Symbol::Global::Name"
section: "3pm"
platform: "linux"
package: "libsymbol-global-name-perl"
version: "0.05-4"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Symbol::Global::Name"
---

# Symbol::Global::Name(3pm)

finds name and type of a global variable

## NAME

Symbol::Global::Name - finds name and type of a global variable

## SYNOPSIS

```
    package My;
    our $VERSION = '0.1';
    use Symbol::Global::Name;
    print Symbol::Global::Name->find( \$VERSION );
    # prints '$My::VERSION'
```

## DESCRIPTION

Lookups symbol table to find an element by reference.

## METHODS

### find

```
    Symbol::Global::Name->find( \$VERSION );
    Symbol::Global::Name->find( \$VERSION, package => 'My::Package' );
    Symbol::Global::Name->find( reference => \$VERSION );
    Symbol::Global::Name->find( reference => \$VERSION, package => 'My::Package' );
```

Takes a reference and optional package name. Returns name of the referenced variable as long as it's in the package or sub-package and it's a global variable. Returned name is prefixed with type sigil, eg. '$', '@', '%', '&' or '\*'.

## AUTHOR

Ruslan Zakirov \<ruz@bestpractical.com\>

## LICENSE

Under the same terms as perl itself.