hexyjs
TypeScript icon, indicating that this package has built-in type declarations

2.1.4 • Public • Published

hexyjs

NPM

Build Status Codecov branch GitHub package.json version

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
 

License

MIT © Jecsham Castillo

Package Sidebar

Install

npm i hexyjs

Weekly Downloads

97

Version

2.1.4

License

MIT

Unpacked Size

9.21 kB

Total Files

10

Last publish

Collaborators

  • jecsham