# isAnagram
> Test if a value is an [anagram][anagram].
## Usage
```javascript
var isAnagram = require( '@stdlib/assert/is-anagram' );
```
#### isAnagram( str, value )
Tests if a `value` is an [anagram][anagram].
```javascript
var str = 'I am a weakish speller';
var value = 'William Shakespeare';
var bool = isAnagram( str, value );
// returns true
```
## Notes
- The function does **not** address the presence of [diacritics][diacritics].
- Only **alphanumeric** characters are considered.
- Capitalization is **ignored**.
- If provided a non-string for the first `argument`, the function throws an `Error`.
- If provided a non-string for the second `argument`, the function returns `false`.
## Examples
```javascript
var isAnagram = require( '@stdlib/assert/is-anagram' );
var bool = isAnagram( 'I am a weakish speller', 'William Shakespeare' );
// returns true
bool = isAnagram( 'bat', 'tab' );
// returns true
bool = isAnagram( 'bat', 'TAB' );
// returns true
bool = isAnagram( 'bat', 't a b' );
// returns true
bool = isAnagram( 'bat 321', 'tab 123' );
// returns true
bool = isAnagram( 'bat', 'tabba' );
// returns false
bool = isAnagram( 'bat', 5 );
// returns false
bool = isAnagram( '123', 321 );
// returns false
```
* * *
## CLI
### Usage
```text
Usage: is-anagram [options] [] --str=
Options:
-h, --help Print this message.
-V, --version Print the package version.
--str string Comparison string.
```
### Examples
```bash
$ is-anagram baz --str=zab
true
```
To use as a [standard stream][standard-streams],
```bash
$ echo -n 'tab\nbaz' | is-anagram --str=bat
true
false
```
[anagram]: http://en.wikipedia.org/wiki/Anagram
[diacritics]: http://en.wikipedia.org/wiki/Diacritic
[standard-streams]: https://en.wikipedia.org/wiki/Standard_streams