# uppercase
> Convert a string to uppercase.
## Usage
```javascript
var uppercase = require( '@stdlib/string/uppercase' );
```
#### uppercase( str )
Converts a `string` to uppercase.
```javascript
var str = uppercase( 'bEEp' );
// returns 'BEEP'
```
## Examples
```javascript
var uppercase = require( '@stdlib/string/uppercase' );
var str;
str = uppercase( 'Beep' );
// returns 'BEEP'
str = uppercase( 'BeEp' );
// returns 'BEEP'
str = uppercase( 'Beep BOOP' );
// returns 'BEEP BOOP'
str = uppercase( '$**_beep_BoOp_**$' );
// returns '$**_BEEP_BOOP_**$'
str = uppercase( '' );
// returns ''
```
* * *
## CLI
### Usage
```text
Usage: uppercase [options] []
Options:
-h, --help Print this message.
-V, --version Print the package version.
```
### Examples
```bash
$ uppercase bEEp
BEEP
```
To use as a [standard stream][standard-streams],
```bash
$ echo -n 'bEEp' | uppercase
BEEP
```
[standard-streams]: https://en.wikipedia.org/wiki/Standard_streams
[@stdlib/string/capitalize]: https://github.com/stdlib-js/string/tree/main/capitalize
[@stdlib/string/lowercase]: https://github.com/stdlib-js/string/tree/main/lowercase