percentEncode

Percent-encode a UTF-16 encoded string according to RFC 3986.

Usage

var percentEncode = require( '@stdlib/string/base/percent-encode' );

percentEncode( str )

Percent-encodes a UTF-16 encoded string according to RFC 3986.

var out = percentEncode( '☃' );
// returns '%E2%98%83'

Notes

The function percent-encodes an entire string. Hence, if provided a URI, the function percent-encodes the entire URI.
```
var out = percentEncode( 'https://en.wikipedia.org/wiki/Mode_(statistics)' );
// returns 'https%3A%2F%2Fen.wikipedia.org%2Fwiki%2FMode_%28statistics%29'
```
To percent-encode a URI, split the URI into separate components, percent-encode relevant components, and then reassemble.

Examples

var percentEncode = require( '@stdlib/string/base/percent-encode' );

var values = [
    'Ladies + Gentlemen',
    'An encoded string!',
    'Dogs, Cats & Mice',
    '☃',
    'æ',
    '𐐷'
];
var i;
for ( i = 0; i < values.length; i++ ) {
    console.log( '%s: %s', values[ i ], percentEncode( values[ i ] ) );
}