# isUppercase
> Test if a value is an uppercase string.
## Usage
```javascript
var isUppercase = require( '@stdlib/assert/is-uppercase' );
```
#### isUppercase( value )
Tests if a `value` is an uppercase `string`.
```javascript
var bool = isUppercase( 'HELLO' );
// returns true
bool = isUppercase( 'salt and light' );
// returns false
```
## Notes
- The function validates that a `value` is a `string`. For all other types, the function returns `false`.
## Examples
```javascript
var isUppercase = require( '@stdlib/assert/is-uppercase' );
var bool = isUppercase( 'HELLO' );
// returns true
bool = isUppercase( '' );
// returns false
bool = isUppercase( 'Hello' );
// returns false
bool = isUppercase( 'hello' );
// returns false
```
* * *
## CLI
### Usage
```text
Usage: is-uppercase [options] []
Options:
-h, --help Print this message.
-V, --version Print the package version.
```
### Examples
```bash
$ is-uppercase BEEP
true
```
To use as a [standard stream][standard-streams],
```bash
$ echo -n 'boop' | is-uppercase
false
```
[standard-streams]: https://en.wikipedia.org/wiki/Standard_streams