#ASCII

Encoding and decoding between strings and ASCII byte sequences.

#Encoding

Use encode to convert a string to ASCII bytes. Panics if the string contains non-ASCII characters.

///|
test "encode" {
  let bytes = @ascii.encode("hello")
  inspect(bytes, content="b\"hello\"")
}

Use decode to convert ASCII bytes back to a string. Raises Malformed if any byte is outside the ASCII range (0-127).

///|
test "decode" {
  let bytes : Bytes = b"\x68\x65\x6C\x6C\x6F"
  let s = @ascii.decode(bytes)
  inspect(s, content="hello")
}

Use decode_lossy to decode bytes that may contain invalid ASCII, replacing invalid bytes with the Unicode replacement character (U+FFFD).

///|
test "decode_lossy" {
  let bytes : Bytes = b"\x68\x80\x6F"
  let s = @ascii.decode_lossy(bytes)
  inspect(s, content="h\u{FFFD}o")
}

pub suberror Malformed {
  Malformed(BytesView)
} derive(@moonbitlang/core/debug.Debug
Debug)

Error type Malformed.

fn decode(bytes : BytesView) -> String raise Malformed

Decodes an ASCII byte array into a string.

Raises Malformed if any byte is outside the ASCII range.

fn decode_lossy(bytes : BytesView) -> String

Decodes ASCII bytes into a string, replacing non-ASCII bytes with U+FFFD.

fn encode(str : StringView) -> Bytes

Encodes a string into an ASCII byte array.

Panics if the string contains any non-ASCII code units.