# isAlphagram
> Test if a value is an [alphagram][alphagram].
## Usage
```javascript
var isAlphagram = require( '@stdlib/assert/is-alphagram' );
```
#### isAlphagram( value )
Tests if a `value` is an [alphagram][alphagram] (i.e., a sequence of characters arranged in alphabetical order).
```javascript
var value = 'beep';
var bool = isAlphagram( value );
// returns true
```
## Notes
- The function first checks that an input `value` is a `string` before validating that the `value` is an [alphagram][alphagram]. For non-string values, the function returns `false`.
## Examples
```javascript
var isAlphagram = require( '@stdlib/assert/is-alphagram' );
var out = isAlphagram( 'beep' );
// returns true
out = isAlphagram( new String( 'beep' ) );
// returns true
out = isAlphagram( '' );
// returns false
out = isAlphagram( 'zba' );
// returns false
out = isAlphagram( 123 );
// returns false
```
* * *
## CLI
### Usage
```text
Usage: is-alphagram [options] []
Options:
-h, --help Print this message.
-V, --version Print the package version.
```
### Examples
```bash
$ is-alphagram beep
true
```
To use as a [standard stream][standard-streams],
```bash
$ echo -n 'hello' | is-alphagram
false
```
[alphagram]: https://en.wiktionary.org/wiki/alphagram
[standard-streams]: https://en.wikipedia.org/wiki/Standard_streams