function mapFromAddressv4
mapFromAddressv4(address: Addressv4): Addressv6

Converts an IPv4 address to its IPv4-mapped IPv6 representation.

Embeds the 32-bit IPv4 address into the ::ffff:0:0/96 prefix, producing the 128-bit IPv4-mapped IPv6 address defined in RFC 4291 Section 2.5.5.2.

Examples

Example 1

import { assertEquals } from "@std/assert";
import { mapFromAddressv4, stringifyAddressv6 } from "@hertzg/ip/addressv6";
import { parseAddressv4 } from "@hertzg/ip/addressv4";

assertEquals(
  stringifyAddressv6(mapFromAddressv4(parseAddressv4("192.168.1.1").address)),
  "::ffff:c0a8:101",
);
assertEquals(
  stringifyAddressv6(mapFromAddressv4(parseAddressv4("127.0.0.1").address)),
  "::ffff:7f00:1",
);
assertEquals(
  stringifyAddressv6(mapFromAddressv4(parseAddressv4("0.0.0.0").address)),
  "::ffff:0:0",
);

Parameters

address: Addressv4

The address as a 32-bit unsigned integer

Return Type

The IPv4-mapped IPv6 address as a 128-bit bigint

Usage

import { mapFromAddressv4 } from "addressv6.ts";