toip
v1.0.4
Published
Converts the IP addresses to their integer representation and vice versa.
Downloads
83
Readme
ToIp
A utility allowing an easy conversion between IP addresses and integers.
An IPv4 address is technically a 32-bit integer that is commonly represented by a string in the format 0.0.0.0. Similarly, IPv6 addresses are 128-bit integers that are commonly represented by a string in the format 0:0:0:0:0:0:0:0.
The ability to convert between these two representations make it easier to iterate over a large number of IP addresses.
Installation
npm install toip
yarn add toip
pnpm add toip
Usage
JavaScript example
const { toIPv4 } = require('toip');
console.log(toIPv4(0)); //prints out 0.0.0.0
console.log(toIPv4(1)); //prints out 0.0.0.1
console.log(toIPv4(4294967295)); //prints out 255.255.255.255
TypeScript example
import { toIPv4 } from 'toip';
console.log(toIPv4(0)); //prints out 0.0.0.0
console.log(toIPv4(1)); //prints out 0.0.0.1
console.log(toIPv4(4294967295)); //prints out 255.255.255.255
Functions
toIPv4(number)
- Converts a number to an IPv4 address represented as string in format0.0.0.0
.ipv4ToNumber(string)
- takes in an IPv4 address represented as a string in format0.0.0.0
and returns the number representation.toIPv6(bigint)
- Converts a number to an IPv6 address represented as string in formatfff:ffff:ffff:ffff:ffff:ffff:ffff:ffff
or just::
for the shorthand representation.ipv6ToNumber(string)
- Converts an IPv6 address string and converts it to abigint
number.