Encoding#

The Encoding type defines a set of supported character encodings used by methods like:

• Data.fromRawString(str, encoding) — converts a text string into binary data using the specified encoding.
• Data.toRawString(encoding) — converts binary data back into a string using the specified encoding.

These encodings allow interoperability with various text formats and systems, ensuring compatibility across languages and platforms.

#Available Encodings

#Example Usage

#Converting a String to Data and Back

// Convert a UTF-8 string to binary data
const text = "こんにちは世界"  // "Hello World" in Japanese
const utf8Data = Data.fromRawString(text, "utf-8")

// Convert the binary data back to a string
const decoded = utf8Data.toRawString("utf-8")

console.log(decoded) // Output: こんにちは世界

#Using a Different Encoding

// Encode using Shift-JIS (Japanese)
const sjisData = Data.fromRawString("テスト", "shiftJIS")

// Decode back from Shift-JIS
const decodedSJIS = sjisData.toRawString("shiftJIS")
console.log(decodedSJIS) // Output: テスト

#Example for Windows Encodings

// Encode text with Central European characters
const text = "Příliš žluťoučký kůň úpěl ďábelské ódy"
const data = Data.fromRawString(text, "windowsCP1250")
const result = data.toRawString("windowsCP1250")
console.log(result)

#Notes

• When encoding or decoding fails (e.g., using the wrong encoding for the data), the returned string may contain invalid characters (�).
• For most use cases, "utf-8" is recommended due to its compatibility and efficiency.
• Legacy encodings such as "shiftJIS", "iso2022JP", and "windowsCP125x" are provided for interoperability with older file formats and systems.