Convertion

Librería simple para conversiones de bases numéricas.

Contenido

• Descripción
• Instalacion
• Guia de uso
  • Handlers
    • num
    • bin
    • oct
    • hex

Descripción

Convertion es una pequeña librería en fase de desarrollo para conversión entre bases numéricas. De momento solo cubre conversiones entre bases binario, octal, decimal y hexadecimal. A medida de lo posible intentaré aportar mayor cantidad de métodos a esta librería, con el fin de que tenga un amplio rango de conversiones

Instalación

Solo se necesita tener instalado node.js y npm

npm install convertion

🚀 Guia de uso

La manera mas simple de usar convertion es.

import { bin, num } from 'convertion';

const binary = num(10).convert().bin(); // returns '1010'

const hexa = bin('1010').convert().dec(); // returns 10

✋ ¿Te fijaste? A pesar de que el método num utiliza de convert el método bin para la conversión, bin > para hacer la conversión a decimal utiliza de convert el método dec.

Esto significa que los métodos que retorna convert no son los mismos handlers. Saber más

Handlers

Estos son los principales métodos de convertion. puedes visitar la documentación para conocer más.

Handler num

Este manejador recibe como parámetros solo expresiones numérica 123, 0b123, etc las cuales convertirá en una expresión decimal. Nos devuelve solo el método convert.

// Ejemplo
let num = num(10).convert().hex();
console.log(num);
// returns a (string)

let num = num(10).convert().bin();
console.log(num);
// returns 1010 (string)

Handler bin

Este manejador recibe como parámetros solo expresiones numéricas de tipo string y binario '0b1100', '110011', etc. El Handler bin devuelve los validadores:

• isNumber(): que devuelve true en caso de ser un string numérico.
• isBinary() que devuelve true si la expresión sigue un patrón binario.

También devuelve el método convert que desde bin nos devuelve tres métodos:

• dec() Retorna la expresión convertida a decimal.
• oct() Retorna la expresión convertida a octal.
• hex() Retorna la expresión convertida a hexadecimal.

// Ejemplos

let number = bin('1010').isNumber();
console.log(number);
//returns true

let number = bin('Hello').isBinary();
console.log(number);
//returns false

let bin = bin('1010').convert().hex();
console.log(bin);
// returns a (string)

Saber mas

Handler oct

Este manejador recibe como parámetros solo expresiones numéricas de tipo string y octal '0o17', '752', etc. El Handler oct devuelve los validadores:

• isNumber(): que devuelve true en caso de ser un string numérico.
• isOctal() que devuelve true si la expresión sigue un patrón octal.

También devuelve el método convert que desde oct nos devuelve tres métodos:

• dec() Retorna la expresión convertida a decimal.
• bin() Retorna la expresión convertida a binario.
• hex() Retorna la expresión convertida a hexadecimal.

// Ejemplos

let number = oct('77').isNumber();
console.log(number);
//returns true

let number = oct('Hello').isOctal();
console.log(number);
//returns false

let oct = oct('20').convert().hex();
console.log(oct);
// returns 10 (string)

Saber mas

Handler hex

Este manejador recibe como parámetros solo expresiones numéricas de tipo string y hexadecimal '0x1ff', '12ff', etc. El Handler hex devuelve los validadores:

• isNumber(): que devuelve true en caso de ser un string numérico.
• ishHex() que devuelve true si la expresión sigue un patrón hexadecimal.

También devuelve el método convert que desde hex nos devuelve tres métodos:

• dec() Retorna la expresión convertida a decimal.
• bin() Retorna la expresión convertida a binario.
• oct() Retorna la expresión convertida a octal.

// Ejemplos

let number = hex('77').isNumber();
console.log(number);
//returns true

let number = hex('Hello').isHex();
console.log(number);
//returns false

let hex = hex('a').convert().dec();
console.log(hex);
// returns 10 (number)

Saber mas

Contribuciones

De momento me encuentro trabajando por mi cuenta en este proyecto. Si deseas contribuir con gusto ajustamos una metodología y comenzamos a colaborarnos en equipo. Déjame un pull request o un correo a [email protected]

Autor

• Ángel Zamora

Licencia

MIT

Donaciones

Si deseas apoyarme para continuar desarrollando más librerías y mejorando las existentes puedes hacerlo por el siguiente link.