use hex

Hexadecimal encoding and decoding. Converts between binary data and hexadecimal string representation.

Functions

fn decode_byte

Decode a 2-character hex string to a byte value. Returns -1 if the input is invalid.

Signature: (hex:str -- b:i64)

Example:

"41" hex::decode_byte  // 65

fn decoded_len

Get the length of data that would result from decoding a hex string. Returns -1 if the hex string has invalid length (odd).

Signature: (hex:str -- len:i64)

Example:

"48656C6C6F" hex::decoded_len  // 5

fn decode

Decode a hexadecimal string to bytes. Accepts both uppercase and lowercase hex digits. Invalid characters are skipped.

Signature: (hex:str -- s:str)

Example:

"48656C6C6F" hex::decode  // "Hello"

fn encode_byte

Encode a single byte (0-255) to a 2-character hex string.

Signature: (b:i64 -- hex:str)

Example:

65 hex::encode_byte  // "41"

fn encoded_len

Get the length of hex string that would result from encoding data.

Signature: (s:str -- len:i64)

Example:

"Hello" hex::encoded_len  // 10

fn encode_lower

Encode a string to lowercase hexadecimal. Each byte becomes two hex characters (00-ff).

Signature: (s:str -- hex:str)

Example:

"Hello" hex::encode_lower  // "48656c6c6f"

fn encode

Encode a string to uppercase hexadecimal. Each byte becomes two hex characters (00-FF).

Signature: (s:str -- hex:str)

Example:

"Hello" hex::encode  // "48656C6C6F"

fn is_valid

Check if a string contains only valid hexadecimal characters. Valid characters are 0-9, A-F, a-f.

Signature: (hex:str -- valid:i64)

Example:

"48656C6C6F" hex::is_valid  // 1
"48ZZ" hex::is_valid  // 0