Encoding

1 min read

Import: import system.encoding;

Encoding

UTF-8 / hex / Base64 encode and decode helpers.

public static class Encoding

utf8_encode

Copies the UTF-8 encoding of text into a new byte[].

public static fun utf8_encode(text: string): byte[]

utf8_decode

Interprets bytes as UTF-8 and builds a Dream string.

public static fun utf8_decode(bytes: byte[]): string

hex_encode

Encodes bytes as lowercase hexadecimal text.

public static fun hex_encode(bytes: byte[]): string

hex_decode

Decodes hexadecimal text into bytes; rejects odd length and non-hex digits.

public static fun hex_decode(text: string): Result<byte[], ParseError>

base64_encode

Encodes bytes as standard Base64 (with = padding).

public static fun base64_encode(bytes: byte[]): string

base64_decode

Decodes Base64 text (whitespace ignored); rejects invalid alphabet characters.

public static fun base64_decode(text: string): Result<byte[], ParseError>

base64url_encode

Encodes bytes as Base64url without padding.

public static fun base64url_encode(bytes: byte[]): string

base64url_decode

Decodes Base64url text (-/_, padding optional).

public static fun base64url_decode(text: string): Result<byte[], ParseError>

uri_encode_component

Percent-encodes text as UTF-8 bytes (RFC 3986 unreserved set left as-is).

public static fun uri_encode_component(text: string): string

uri_decode_component

Decodes percent escapes as strict UTF-8, preserving literal +. Malformed escapes or invalid UTF-8 return a parse error.

public static fun uri_decode_component(text: string): Result<string, ParseError>

form_encode_component

Encodes a form component as UTF-8, using + for spaces and percent escapes except for ASCII letters, digits, *, -, ., and _.

public static fun form_encode_component(text: string): string

form_decode_component

Decodes a form component, interpreting + as space and validating escaped UTF-8. Malformed escapes or invalid UTF-8 return a parse error.

public static fun form_decode_component(text: string): Result<string, ParseError>