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