# pkg2alias
> Return the alias associated with a specified package name.
## Usage
```javascript
var pkg2alias = require( '@stdlib/namespace/pkg2alias' );
```
#### pkg2alias( pkg )
Returns the alias associated with a specified package name.
```javascript
var v = pkg2alias( '@stdlib/math/base/special/sin' );
// returns 'base.sin'
```
If provided an unrecognized `pkg`, the function returns `null`.
```javascript
var v = pkg2alias( 'unrecognized_pkg_beep_boop_bop_bip' );
// returns null
```
## Notes
- The function supports providing both internal and standalone package names.
```javascript
var v = pkg2alias( '@stdlib/math-base-special-sin' );
// returns 'base.sin'
```
## Examples
```javascript
var discreteUniform = require( '@stdlib/random/base/discrete-uniform' );
var aliases = require( '@stdlib/namespace/aliases' );
var alias2pkg = require( '@stdlib/namespace/alias2pkg' );
var pkg2alias = require( '@stdlib/namespace/pkg2alias' );
var list;
var len;
var idx;
var v1;
var v2;
var i;
list = aliases();
len = list.length;
// Round-trip from alias-to-pkg-to-alias...
for ( i = 0; i < 100; i++ ) {
idx = discreteUniform( 0, len-1 );
v1 = alias2pkg( list[ idx ] );
v2 = pkg2alias( v1 );
console.log( 'alias: %s. pkg: %s.', list[ idx ], v1 );
console.log( 'pkg: %s. alias: %s.', v1, v2 );
}
```
* * *
## CLI
### Usage
```text
Usage: stdlib-pkg2alias [options]
Options:
-h, --help Print this message.
-V, --version Print the package version.
```
### Examples
```bash
$ stdlib-pkg2alias '@stdlib/math/base/special/sin'
base.sin
```
## License
The data files (databases) are licensed under an [Open Data Commons Public Domain Dedication & License 1.0][pddl-1.0] and their contents are licensed under [Creative Commons Zero v1.0 Universal][cc0]. The software is licensed under [Apache License, Version 2.0][apache-license].
[pddl-1.0]: http://opendatacommons.org/licenses/pddl/1.0/
[cc0]: https://creativecommons.org/publicdomain/zero/1.0
[apache-license]: https://www.apache.org/licenses/LICENSE-2.0
[@stdlib/namespace/alias2pkg]: https://github.com/stdlib-js/namespace/tree/main/alias2pkg
[@stdlib/namespace/aliases]: https://github.com/stdlib-js/namespace/tree/main/aliases
[@stdlib/namespace/pkg2related]: https://github.com/stdlib-js/namespace/tree/main/pkg2related