Skip to content

UTF-16 ​

Assinaturautf16.encode(text: string): u16[]
Assinaturautf16.encodeLE(text: string): u8[]
Assinaturautf16.encodeBE(text: string): u8[]
Assinaturautf16.decode(units: u16[]): Result<string, EncodingError>
Assinaturautf16.decodeLossy(units: u16[]): string
Assinaturautf16.decodeLE(bytes: u8[]): Result<string, EncodingError>
Assinaturautf16.decodeLELossy(bytes: u8[]): string
Assinaturautf16.decodeBE(bytes: u8[]): Result<string, EncodingError>
Assinaturautf16.decodeBELossy(bytes: u8[]): string

Importe utf16 de tyrus:encoding. encode(text) retorna unidades u16 independentes do host. encodeLE(text) e encodeBE(text) retornam arrays de bytes na ordem escolhida explicitamente. decode, decodeLE e decodeBE são estritos; os métodos Lossy correspondentes substituem sequências surrogate inválidas por U+FFFD.

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

const units: u16[] = utf16.encode("A😀");
const littleEndian: u8[] = utf16.encodeLE("A😀");
const bigEndian: u8[] = utf16.encodeBE("A😀");
const malformed: u16[] = [55296];

try {
    print(utf16.decode(units)); // A😀
    print(utf16.decodeLE(littleEndian)); // A😀
    print(utf16.decodeBE(bigEndian)); // A😀
} catch (error: EncodingError) {
    print(error.code);
}
print(utf16.decodeLossy(malformed)); // �

Decoders orientados a bytes exigem uma quantidade par de bytes. As variantes estritas retornam Err(EncodingError) para comprimento ímpar ou sequência surrogate inválida; as variantes lossy reparam apenas sequências surrogate inválidas.