time-to-botec/squiggle/node_modules/@stdlib/string/percent-encode
NunoSempere b6addc7f05 feat: add the node modules
Necessary in order to clearly see the squiggle hotwiring.
2022-12-03 12:44:49 +00:00
..
bin feat: add the node modules 2022-12-03 12:44:49 +00:00
docs feat: add the node modules 2022-12-03 12:44:49 +00:00
etc feat: add the node modules 2022-12-03 12:44:49 +00:00
lib feat: add the node modules 2022-12-03 12:44:49 +00:00
package.json feat: add the node modules 2022-12-03 12:44:49 +00:00
README.md feat: add the node modules 2022-12-03 12:44:49 +00:00

Percent-encoding

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

Usage

var percentEncode = require( '@stdlib/string/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/percent-encode' );

var values;
var out;
var i;

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

CLI

Usage

Usage: percent-encode [options] [<string>]

Options:

  -h,    --help                Print this message.
  -V,    --version             Print the package version.

Examples

$ percent-encode ☃
%E2%98%83

To use as a standard stream,

$ echo -n '☃' | percent-encode
%E2%98%83