hexly-str-js
v2.1.5
Published
Hexadecimal utilities
Downloads
6
Maintainers
Readme
hexyjs
A simple library with some hexadecimal utilities.
Install
$ npm install hexyjs
Basic Usage
const hexyjs = require("hexyjs");
/* String to Hexadecimal */
hexyjs.strToHex("Cave Story");
// => 436176652053746f7279
/* Hexadecimal to String */
hexyjs.hexToStr("436176652053746f7279");
// => Cave Story
hexyjs.hexToStr("W36176652053746f727P"); // invalid hex string
// => false
/* Validate a Hexadecimal string */
hexyjs.isHex("436176652053746f7279");
// => true
hexyjs.isHex("43 61 76 65 20 53 74 6f 72 79");
// => true
hexyjs.isHex("32JGD");
// => false
API
hexToStr(hex: string): string | false
Decode a hexadecimal string
isHex(hex: string, stric?: boolean): boolean
Validate a hexadecimal string.
- strict: If enabled, this will return false if the string length is not divisible by 2 (invalid hexadecimal string length). If you disabled it, you can validate strings with any length. Check the following example. (default: true)
hexyjs.isHex("1"); // strict enabled
// => false
hexyjs.isHex("1", false); // strict disabled
// => true
strToHex(str: string, options?: strToHexOptions): string
Encode a string to a hexadecimal string. You can use this function with options to change the output.
- grouped: Enable/disable grouped output. (default: false)
- uppercase: Enable/disable the uppercase output. (default: false)
strToHexOptions {
uppercase?: boolean,
grouped?: boolean
}
hexyjs.strToHex("Cave Story", { uppercase: true });
// => 436176652053746F7279
hexyjs.strToHex("Cave Story", { grouped: true });
// => 43 61 76 65 20 53 74 6f 72 79