Datos binarios: Bytes, Hash y Base64

Bytes

Un bloque de bytes (números de 0 a 255). Sirve para leer y escribir formatos de archivo (imágenes, sonidos, partidas guardadas), protocolos de red, emuladores o imágenes de disco.

var b = Bytes([72, 111, 108, 97])     // también Bytes(tamaño), Bytes("texto") o Bytes(otro)
print(b, b.length, b[0], b.toText())
b[0] = 104
b.push(33)                            // añadir al final (números, listas, textos u otros Bytes)
print(b.toText(), b.toHex(" "), b.toList())

Números de varios bytes

Los métodos read* y write* leen y escriben enteros y decimales en una posición. Por defecto en little endian (el orden de x86 y ARM); con false al final, en big endian (el de las redes).

// Cabecera de un formato inventado: firma "HZS1", versión (u16) y número de niveles (u32)
var cab = Bytes("HZS1").pushU16(2).pushU32(15)
print(cab.toHex(" "))
print(cab.slice(0, 4).toText(), cab.readU16(4), cab.readU32(6))
print(cab.readU16(4, false)) // el mismo dato leído en big endian

Más métodos: slice(desde, hasta), concat(otro), indexOf(buscado), fill(valor), resize(n), copy(), equals(otro) (y ==). File.readBytes(ruta) y File.writeBytes(ruta, bytes) leen y escriben archivos binarios.

Hash

Huellas para comprobar que unos datos no han cambiado, comparar archivos o generar identificadores.

print(Hash.sha256("hola"))     // SHA-256 en hexadecimal
print(Hash.crc32("hola"))      // CRC-32 (el de ZIP y PNG)
print(Hash.fnv1a("hola"))      // rápido, no criptográfico
print(Hash.uuid().length)      // identificador único aleatorio

Base64

Para meter datos binarios dentro de texto (JSON, correos, URLs):

var codificado = Base64.encode("¡Hola!")
print(codificado, Base64.decode(codificado))
print(Bytes([0, 255]).toBase64(), Base64.decodeBytes("AP8=").toList())

Compresión

compress(nivel) comprime con zlib (el algoritmo de ZIP y PNG) y decompress() lo deshace:

var datos = Bytes("HyperEZ " * 500)
var z = datos.compress(9)
print(datos.length, "->", z.length, "bytes")
print(z.decompress().toText() == datos.toText())

Números en otras bases

print((255).toHex(), (255).toHex(4), (5).toBinary(8), (35).toBase(36))
print(parseInt("ff", 16), parseInt("0x1F", 16), parseInt("1010", 2))
print(0xFF & 0x0F, 1 << 8, ~0)

Archivos .zip: import zip

Crea y lee archivos .zip normales (los abren Windows, macOS, Linux y cualquier programa de zip). Usa la compresión deflate de Bytes.compress(nivel, true) y comprueba el CRC de cada archivo al leer.

import zip

zip.create("copia.zip", { "notas.txt": "hola", "datos/puntos.json": JSON.stringify([1, 2, 3]) })
print(zip.list("copia.zip"))                      // [notas.txt, datos/puntos.json]
print(zip.read("copia.zip")["notas.txt"].toText())
zip.extract("copia.zip", "extraido")
zip.createFromFolder("todo.zip", "extraido")      // una carpeta entera
print(zip.list("todo.zip").length)

Los contenidos pueden ser textos o Bytes. extract rechaza rutas con .. (un zip no puede escribir fuera de la carpeta de destino).

Más huellas

print(Hash.md5("abc"))                            // 900150983cd24fb0d6963f7d28e17f72
print(Hash.sha1("abc"))                           // la huella que usa Git
print(Hash.hmac("clave secreta", "mensaje"))      // firma HMAC-SHA256 (APIs web, tokens)

MD5 y SHA-1 sirven para comprobar archivos y compatibilidad con otros programas, no para seguridad (usa sha256 o hmac).