# reverseString
> Reverse a string.
## Usage
```javascript
var reverseString = require( '@stdlib/string/reverse' );
```
#### reverseString( str )
Reverses a `string`.
```javascript
var out = reverseString( 'last man standing' );
// returns 'gnidnats nam tsal'
out = reverseString( 'Hidden Treasures' );
// returns 'serusaerT neddiH'
out = reverseString( 'Lorem ipsum 𝌆 dolor sit ameͨ͆t.' );
// returns '.teͨ͆ma tis rolod 𝌆 muspi meroL'
```
## Examples
```javascript
var reverseString = require( '@stdlib/string/reverse' );
var str = reverseString( 'last man standing' );
// returns 'gnidnats nam tsal'
str = reverseString( 'presidential election' );
// returns 'noitcele laitnediserp'
str = reverseString( 'javaScript' );
// returns 'tpircSavaj'
str = reverseString( 'Hidden Treasures' );
// returns 'serusaerT neddiH'
```
* * *
## CLI
### Usage
```text
Usage: reverse [options] []
Options:
-h, --help Print this message.
-V, --version Print the package version.
--split sep Delimiter for stdin data. Default: '/\\r?\\n/'.
```
### Notes
- If the split separator is a [regular expression][mdn-regexp], ensure that the `split` option is either properly escaped or enclosed in quotes.
```bash
# Not escaped...
$ echo -n $'beep\nboop' | reverse --split /\r?\n/
# Escaped...
$ echo -n $'beep\nboop' | reverse --split /\\r?\\n/
```
- The implementation ignores trailing delimiters.
### Examples
```bash
$ reverse foobar
raboof
```
To use as a [standard stream][standard-streams],
```bash
$ echo -n 'foobar' | reverse
raboof
```
By default, when used as a [standard stream][standard-streams], the implementation assumes newline-delimited data. To specify an alternative delimiter, set the `split` option.
```bash
$ echo -n 'foobar\tbaz' | reverse --split '\t'
raboof
zab
```
[mdn-regexp]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions
[standard-streams]: https://en.wikipedia.org/wiki/Standard_streams