Skip to content

UTF-8 ​

Assinaturautf8.encode(text: string): u8[]
Assinaturautf8.decode(bytes: u8[]): Result<string, EncodingError>
Assinaturautf8.decodeLossy(bytes: u8[]): string

Importe utf8 de tyrus:encoding. encode(text) retorna os bytes UTF-8 de uma string. decode(bytes) aceita somente UTF-8 bem-formado e retorna Err(EncodingError) nos demais casos. decodeLossy(bytes) substitui cada sequência inválida por U+FFFD.

tyrus
import { EncodingError, utf8 } from "tyrus:encoding";

const bytes: u8[] = utf8.encode("hello 🌍");
const malformed: u8[] = [255];

try {
    print(utf8.decode(bytes)); // hello 🌍
} catch (error: EncodingError) {
    print(error.code);
}
print(utf8.decodeLossy(malformed)); // �

UTF-8 não tem forma little-endian nem big-endian: seus valores codificados são sequências de bytes definidos individualmente. Endianness só se aplica quando uma codificação usa unidades de código com múltiplos bytes, como UTF-16.