Skip to content

UTF-16 ​

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

Importe utf16 de tyrus:encoding. encode(text) devuelve unidades u16 independientes del host. encodeLE(text) y encodeBE(text) devuelven arrays de bytes en el orden elegido explícitamente. decode, decodeLE y decodeBE son estrictos; los métodos Lossy correspondientes sustituyen secuencias surrogate no vá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)); // �

Los decodificadores orientados a bytes requieren una cantidad par de bytes. Las variantes estrictas devuelven Err(EncodingError) para una longitud impar o una secuencia surrogate no válida; las variantes lossy reparan solo secuencias surrogate no válidas.