v2.4.2(1)

Author: 001ProMax

docs/en/guide/doc_v2/Utilities/Data.mdx

@@ -1,192 +1,192 @@
 # Data 
 
-`Data` 类用于表示二进制数据，提供多种方法用于数据的创建、转换、压缩、解压、拼接、读取等操作。可用于处理图像、文件、音频、编码数据等各种原始字节数据。
+The `Data` class represents binary data in memory and provides a wide range of methods for manipulating, converting, compressing, decompressing, and transforming that data. It is useful for working with raw byte buffers, encoded files, images, and more.
 
 ---
 
-## CompressionAlgorithm（压缩算法枚举）
+## CompressionAlgorithm (Enum)
 
-该枚举用于指定 `Data` 的压缩或解压算法：
+Specifies which compression algorithm to use when compressing or decompressing a `Data` instance:
 
-| 枚举值     | 描述                    |
-| ------- | --------------------- |
-| `lzfse` | LZFSE 压缩算法，快速且高效。     |
-| `lz4`   | LZ4 压缩算法，压缩和解压速度极快。   |
-| `lzma`  | LZMA 算法，压缩率高，压缩速度较慢。  |
-| `zlib`  | Zlib 算法，通用且广泛支持的压缩格式。 |
+| Value   | Description                                               |
+| ------- | --------------------------------------------------------- |
+| `lzfse` | Fast and efficient compression using the LZFSE algorithm. |
+| `lz4`   | Very fast compression with moderate compression ratio.    |
+| `lzma`  | High compression ratio, slower performance.               |
+| `zlib`  | Standard and widely-used compression format.              |
 
 ---
 
-## 实例属性与方法
+## Instance Properties and Methods
 
 ### `size: number`
 
-当前数据的字节长度（只读属性）。
+The length of the data in bytes (read-only).
 
 ---
 
 ### `resetBytes(startIndex: number, endIndex: number): void`
 
-将数据中指定范围内的字节清零。
+Resets a range of bytes to zero.
 
-* `startIndex`：起始索引（包含）
-* `endIndex`：结束索引（不包含）
+* `startIndex`: Starting index (inclusive)
+* `endIndex`: Ending index (exclusive)
 
-若索引超出范围将抛出异常。
+Throws an error if the indices are out of bounds.
 
 ---
 
 ### `advanced(amount: number): Data`
 
-返回一个新的 `Data` 实例，去除前 `amount` 个字节。
+Returns a new `Data` instance by removing the first `amount` bytes from the buffer.
 
 ---
 
 ### `replaceSubrange(startIndex, endIndex, data): void`
 
-将当前数据中指定范围的字节替换为另一个 `Data` 实例的数据。
+Replaces a specified byte range with the content of another `Data` instance.
 
 ---
 
 ### `compressed(algorithm: CompressionAlgorithm): Data`
 
-使用指定的压缩算法压缩当前数据，返回压缩后的新 `Data` 实例。
+Compresses the current data using the specified algorithm and returns a new `Data` instance.
 
-如果数据为空或无法压缩将抛出异常。
+Throws an error if the data is empty or cannot be compressed.
 
 ---
 
 ### `decompressed(algorithm: CompressionAlgorithm): Data`
 
-使用指定的算法对当前数据进行解压，返回解压后的 `Data` 实例。
+Decompresses the current data using the specified algorithm and returns a new `Data` instance.
 
-压缩与解压时使用的算法必须一致。
+Must use the same algorithm that was used to compress the data.
 
 ---
 
 ### `slice(start?: number, end?: number): Data`
 
-返回数据的子集片段，形成新的 `Data` 实例。
+Returns a new `Data` instance representing a slice of the original.
 
-* `start`：起始索引（默认 0）
-* `end`：结束索引（默认到末尾）
+* `start`: Starting index (default is `0`)
+* `end`: Ending index (default is the end of the data)
 
 ---
 
 ### `append(other: Data): void`
 
-将另一个 `Data` 实例的数据追加到当前数据末尾。
+Appends another `Data` instance to the end of the current one.
 
 ---
 
-### `getBytes(): Uint8Array | null`（已废弃）
+### `getBytes(): Uint8Array | null` (Deprecated)
 
-请改用 `toUint8Array()`。
+Use `toUint8Array()` instead.
 
 ---
 
 ### `toUint8Array(): Uint8Array | null`
 
-将数据转换为 `Uint8Array`。
+Converts the data into a `Uint8Array`.
 
 ---
 
 ### `toArrayBuffer(): ArrayBuffer`
 
-将数据转换为 `ArrayBuffer`。
+Converts the data into an `ArrayBuffer`.
 
 ---
 
 ### `toBase64String(): string`
 
-将数据编码为 Base64 字符串。
+Returns a Base64-encoded string representation of the data.
 
 ---
 
 ### `toHexString(): string`
 
-将数据编码为十六进制字符串。
+Returns a hexadecimal string representation of the data.
 
 ---
 
 ### `toRawString(encoding?: string): string | null`
 
-将数据转换为字符串，支持指定编码（默认 `"utf-8"`）。
+Converts the data into a string using the specified encoding (default: `"utf-8"`).
 
 ---
 
 ### `toIntArray(): number[]`
 
-将数据转换为由整数表示的字节数组。
+Returns an array of integers representing the bytes of the data.
 
 ---
 
-## 静态方法
+## Static Methods
 
 ### `Data.fromIntArray(array: number[]): Data`
 
-从整数数组创建 `Data` 实例。
+Creates a `Data` instance from an array of integers.
 
 ---
 
-### `Data.fromString(str: string, encoding?: string): Data | null`（已废弃）
+### `Data.fromString(str: string, encoding?: string): Data | null` (Deprecated)
 
-请使用 `Data.fromRawString()` 代替。
+Use `Data.fromRawString()` instead.
 
 ---
 
 ### `Data.fromRawString(str: string, encoding?: string): Data | null`
 
-从字符串创建 `Data` 实例，支持指定编码（默认 `"utf-8"`）。
+Creates a `Data` instance from a raw string, using the specified encoding (default: `"utf-8"`).
 
 ---
 
 ### `Data.fromFile(filePath: string): Data | null`
 
-从本地文件路径读取数据，返回 `Data` 实例。
+Reads binary data from a file path and returns a `Data` instance.
 
 ---
 
 ### `Data.fromArrayBuffer(buffer: ArrayBuffer): Data | null`
 
-从 `ArrayBuffer` 创建 `Data` 实例。
+Creates a `Data` instance from an `ArrayBuffer`.
 
 ---
 
 ### `Data.fromUint8Array(bytes: Uint8Array): Data | null`
 
-从 `Uint8Array` 创建 `Data` 实例。
+Creates a `Data` instance from a `Uint8Array`.
 
 ---
 
 ### `Data.fromBase64String(base64: string): Data | null`
 
-从 Base64 编码字符串创建 `Data` 实例。
+Creates a `Data` instance from a Base64-encoded string.
 
 ---
 
 ### `Data.fromHexString(hex: string): Data | null`
 
-从十六进制字符串创建 `Data` 实例。
+Creates a `Data` instance from a hexadecimal string.
 
 ---
 
 ### `Data.fromJPEG(image: UIImage, compressionQuality?: number): Data | null`
 
-将图像转为 JPEG 格式的 `Data` 实例。
+Converts a `UIImage` to JPEG format data.
 
-* `compressionQuality`：JPEG 压缩质量，范围 0.0 ~ 1.0，默认值为 1.0（最高质量）
+* `compressionQuality`: Compression quality between `0.0` and `1.0` (default: `1.0`)
 
 ---
 
 ### `Data.fromPNG(image: UIImage): Data | null`
 
-将图像转为 PNG 格式的 `Data` 实例。
+Converts a `UIImage` to PNG format data.
 
 ---
 
 ### `Data.combine(dataList: Data[]): Data`
 
-将多个 `Data` 实例合并为一个新实例。
+Combines multiple `Data` instances into one.
 
-如果列表为空或所有数据为空，则返回空数据。
+Returns `null` if the list is empty or all items are empty.