类 Byte

constructor

• new Byte(data?: any): Byte

  参数

  • data: any = null

    Specifies the number of elements for initialization, or a TypedArray object or ArrayBuffer object for initialization. If null, allocate a certain amount of memory in advance. When available space is not enough, use this part of the memory first, and reallocate the required memory if it is still not enough.

  返回 Byte

  En

  Constructor method.

  Zh

  构造方法

静态BIG_ENDIAN

静态LITTLE_ENDIAN

buffer

• get buffer(): ArrayBuffer

  返回 ArrayBuffer

  En

  The ArrayBuffer data of this object, which contains only the valid data part.

  Zh

  此对象的 ArrayBuffer 数据，数据只包含有效数据部分。

bytesAvailable

• get bytesAvailable(): number

  返回 number

  En

  The number of bytes available to read from the current position to the end of the byte stream.

  Zh

  从当前位置到字节流末尾可读取的数据的字节数。

endian

• get endian(): string

  返回 string

  En

  The byte order of the Byte instance. Possible values are BIG_ENDIAN or LITTLE_ENDIAN. The host byte order is one of two sequences used by the CPU to store data, which includes little-endian and big-endian byte orders.The current system's byte order can be obtained using getSystemEndian. BIG_ENDIAN: Big-endian byte order, where the lower memory address stores the higher-order bits of a number, and is sometimes referred to as network byte order. LITTLE_ENDIAN: Little-endian byte order, where the lower memory address stores the lower-order bits of a number.

  Zh

  Byte 实例的字节序。取值为 BIG_ENDIAN 或 LITTLE_ENDIAN。 主机字节序是 CPU 存放数据的两种不同顺序，包括小端字节序和大端字节序。可以通过 getSystemEndian 获取当前系统的字节序。 BIG_ENDIAN ：大端字节序，地址低位存储值的高位，地址高位存储值的低位。有时也称之为网络字节序。 LITTLE_ENDIAN ：小端字节序，地址低位存储值的低位，地址高位存储值的高位。

• set endian(value: string): void

  参数

  • value: string

  返回 void

length

• get length(): number

  返回 number

pos

• get pos(): number

  返回 number

  En

  The current position of the Byte object's read/write pointer (in bytes). When reading, the next read operation will start at this position. When writing, the next write operation will start at this position.

  Zh

  Byte对象的读写指针的当前位置（以字节为单位）。 下一次调用读取方法时将在此位置开始读取，或者下一次调用写入方法时将在此位置开始写入。

• set pos(value: number): void

  参数

  • value: number

  返回 void

clear

• clear(): void

  返回 void

  En

  Clears the content of the byte array and resets the length and pos properties to 0. Calling this method will release the memory occupied by the Byte instance.

  Zh

  清除字节数组的内容，并将 length 和 pos 属性重置为 0。调用此方法将释放 Byte 实例占用的内存。

getUTFBytes

• getUTFBytes(len?: number): string

  参数

  • len: number = -1

    The length of the buffer to read. If set to -1, all data in the buffer will be read.

  返回 string

  The read string.

  En

  Reads a UTF-8 byte sequence of a specified length from the byte stream and returns a string. Typically used to read strings written with the writeUTFBytes method.

  Zh

  从字节流中读取一个由 length 参数指定的长度的 UTF-8 字节序列，并返回一个字符串。 一般读取的是由 writeUTFBytes 方法写入的字符串。

getUTFString

• getUTFString(): string

  返回 string

  The read string.

  En

  Reads a UTF-8 string from the byte stream, assuming the string is prefixed with an unsigned short indicating the length to read. The corresponding writing method is writeUTFString.

  Zh

  从字节流中读取一个 UTF-8 字符串，假定字符串的前缀是一个无符号的短整型（以此字节表示要读取的长度）。 对应的写入方法为：writeUTFString。

readArrayBuffer

• readArrayBuffer(length: number): ArrayBuffer

  参数

  • length: number

    The length of the ArrayBuffer to read.

  返回 ArrayBuffer

  En

  Reads an ArrayBuffer of the specified length from the byte stream.

  Zh

  读取ArrayBuffer数据，长度由参数指定。

readByte

• readByte(): number

  返回 number

  An integer between -128 and 127.

  En

  Reads a signed byte from the byte stream. The return value is in the range of -128 to 127.

  Zh

  从字节流中读取带符号的字节。返回值的范围是从 -128 到 127。

readFloat32

• readFloat32(): number

  返回 number

  The 32-bit floating-point number.

  En

  Reads a 32-bit floating-point number from the current position in the byte stream using IEEE 754 format.

  Zh

  从字节流的当前字节偏移位置处读取一个 IEEE 754 单精度（32 位）浮点数。

readFloat32Array

• readFloat32Array(start: number, len: number): any

  参数

  • start: number

    The starting position.
  • len: number

    The number of bytes to read. If the length to be read exceeds the readable range, only the values within the readable range are returned.

  返回 any

  The read Float32Array object.

  En

  Reads a number of bytes specified by the len parameter from the byte stream starting at the position indicated by the start parameter, and creates a Float32Array object from the data.

  Zh

  从字节流中 start 参数指定的位置开始，读取 len 参数指定的字节数的数据，用于创建一个 Float32Array 对象并返回此对象。

readFloat64

• readFloat64(): number

  返回 number

  The 64-bit floating-point number.

  En

  Reads a 64-bit floating-point number from the current position in the byte stream using IEEE 754 format.

  Zh

  从字节流的当前字节偏移量位置处读取一个 IEEE 754 双精度（64 位）浮点数。

readInt16

• readInt16(): number

  返回 number

  The Int16 value that was read.

  En

  Reads an Int16 value from the current byte offset in the byte stream.

  Zh

  从字节流的当前字节偏移量位置处读取一个 Int16 值。

readInt16Array

• readInt16Array(start: number, len: number): any

  参数

  • start: number

    The byte offset from the start of the stream to begin reading.
  • len: number

    The number of bytes to read. Only values within the readable range are returned if the length exceeds the range.

  返回 any

  The created Int16Array object.

  En

  Reads a number of bytes specified by the len parameter from the byte stream starting at the position indicated by the start parameter, and creates an Int16Array object from the data.

  Zh

  从字节流中 start 参数指定的位置开始，读取 len 参数指定的字节数的数据，用于创建一个 Int16Array 对象并返回此对象。

readInt32

• readInt32(): number

  返回 number

  The Int32 value that was read.

  En

  Reads an Int32 value from the current position in the byte stream.

  Zh

  从字节流的当前字节偏移量位置处读取一个 Int32 值。

readString

• readString(): string

  返回 string

  The read string.

  En

  Commonly used to parse a byte stream in a fixed format. First, read a Uint16 value from the current byte offset of the byte stream, and then read a string of this length.

  Zh

  常用于解析固定格式的字节流。 先从字节流的当前字节偏移位置处读取一个 Uint16 值，然后以此值为长度，读取此长度的字符串。

readUint16

• readUint16(): number

  返回 number

  The Uint16 value that was read.

  En

  Reads a Uint16 value from the current byte offset in the byte stream.

  Zh

  从字节流的当前字节偏移量位置处读取一个 Uint16 值。

readUint32

• readUint32(): number

  返回 number

  The Uint32 value that was read.

  En

  Reads a Uint32 value from the current position in the byte stream.

  Zh

  从字节流的当前字节偏移量位置处读取一个 Uint32 值。

readUint8

• readUint8(): number

  返回 number

  The Uint8 value that was read.

  En

  Reads a Uint8 value from the current byte offset in the byte stream.

  Zh

  从字节流的当前字节偏移量位置处读取一个 Uint8 值。

readUint8Array

• readUint8Array(start: number, len: number): Uint8Array

  参数

  • start: number

    The starting position.
  • len: number

    The number of bytes to read. If the length to be read exceeds the readable range, only the values within the readable range are returned.

  返回 Uint8Array

  The read Uint8Array object.

  En

  Reads a number of bytes specified by the len parameter from the byte stream starting at the position indicated by the start parameter, and creates a Uint8Array object from the data.

  Zh

  从字节流中 start 参数指定的位置开始，读取 len 参数指定的字节数的数据，用于创建一个 Uint8Array 对象并返回此对象。

writeArrayBuffer

• writeArrayBuffer(arraybuffer: any, offset?: number, length?: number): void

  参数

  • arraybuffer: any

    The ArrayBuffer object to write from.
  • offset: number = 0

    The offset index of the ArrayBuffer object (in bytes).
  • length: number = 0

    The length to write from the ArrayBuffer object into the Byte object (in bytes).

  返回 void

  En

  Writes a byte sequence from the specified arraybuffer object into the byte stream, starting at the offset and with the specified length. If the length parameter is omitted, the default length of 0 is used, and the method writes the entire buffer from the offset, if the offset is also omitted, the entire buffer is written. The function will throw an exception if the offset or length is less than 0.

  Zh

  将指定 arraybuffer 对象中的以 offset 为起始偏移量，length 为长度的字节序列写入字节流。 如果省略 length 参数，则使用默认长度 0，该方法将从 offset 开始写入整个缓冲区；如果还省略了 offset 参数，则写入整个缓冲区。 如果 offset 或 length 小于0，本函数将抛出异常。

writeByte

• writeByte(value: number): void

  参数

  • value: number

    The byte to write (0-255).

  返回 void

  En

  Writes a byte to the byte stream. Only the lower 8 bits of the parameter are used. The higher 24 bits are ignored.

  Zh

  在字节流中写入一个字节。只使用参数的低 8 位。忽略高 24 位。

writeFloat32

• writeFloat32(value: number): void

  参数

  • value: number

    The single-precision (32-bit) floating point number to be written.

  返回 void

  En

  Writes an IEEE 754 single-precision (32-bit) floating point number to the byte stream at the current position.

  Zh

  在字节流的当前字节偏移量位置处写入一个 IEEE 754 单精度（32 位）浮点数。

writeFloat64

• writeFloat64(value: number): void

  参数

  • value: number

    The double-precision (64-bit) floating point number to be written.

  返回 void

  En

  Writes an IEEE 754 double-precision (64-bit) floating point number to the byte stream at the current position.

  Zh

  在字节流的当前字节偏移量位置处写入一个 IEEE 754 双精度（64 位）浮点数。

writeInt16

• writeInt16(value: number): void

  参数

  • value: number

    The Int16 value to be written.

  返回 void

  En

  Writes the specified Int16 value to the byte stream at the current byte offset.

  Zh

  在字节流的当前字节偏移量位置处写入指定的 Int16 值。

writeInt32

• writeInt32(value: number): void

  参数

  • value: number

    The Int32 value to be written.

  返回 void

  En

  Writes the specified Int32 value to the byte stream at the current position.

  Zh

  在字节流的当前字节偏移量位置处写入指定的 Int32 值。

writeUint16

• writeUint16(value: number): void

  参数

  • value: number

    The Uint16 value to be written.

  返回 void

  En

  Writes the specified Uint16 value to the byte stream at the current byte offset.

  Zh

  在字节流的当前字节偏移量位置处写入指定的 Uint16 值。

writeUint32

• writeUint32(value: number): void

  参数

  • value: number

    The Uint32 value to be written.

  返回 void

  En

  Writes the specified Uint32 value to the byte stream at the current position.

  Zh

  在字节流的当前字节偏移量位置处写入 Uint32 值。

writeUint8

• writeUint8(value: number): void

  参数

  • value: number

    The Uint8 value to be written.

  返回 void

  En

  Writes the specified Uint8 value to the byte stream at the current byte offset.

  Zh

  在字节流的当前字节偏移量位置处写入指定的 Uint8 值。

writeUTFBytes

• writeUTFBytes(value: string): void

  参数

  • value: string

    The string to write.

  返回 void

  En

  Writes a UTF-8 string to the byte stream. Similar to the writeUTF() method, but writeUTFBytes() does not prefix the string with a 16-bit length word. The corresponding reading method is getUTFBytes.

  Zh

  将 UTF-8 字符串写入字节流。类似于 writeUTF() 方法，但 writeUTFBytes() 不使用 16 位长度的字节为字符串添加前缀。 对应的读取方法为： getUTFBytes 。

writeUTFString

• writeUTFString(value: string): void

  参数

  • value: string

    The string value to write.

  返回 void

  En

  Writes a UTF-8 string to the byte stream. First, the length of the UTF-8 string in bytes is written (as a 16-bit integer), followed by the bytes representing the string characters. The corresponding reading method is getUTFString.

  Zh

  将 UTF-8 字符串写入字节流。先写入以字节表示的 UTF-8 字符串长度（作为 16 位整数），然后写入表示字符串字符的字节。 对应的读取方法为： getUTFString 。

writeUTFString32

• writeUTFString32(value: string): void

  参数

  • value: string

    The string value to write.

  返回 void

  En

  Writes a UTF-8 string to the byte stream. First, the length of the UTF-8 string in bytes is written (as a 32-bit integer), followed by the bytes representing the string characters.

  Zh

  将 UTF-8 字符串写入字节流。先写入以字节表示的 UTF-8 字符串长度（作为 32 位整数），然后写入表示字符串字符的字节。

静态getSystemEndian

• getSystemEndian(): string

  返回 string

  The byte order of the current system.

  En

  Get the byte order of the current host. The host byte order refers to the two different sequences in which a CPU stores data, which includes little-endian and big-endian. BIG_ENDIAN: Big-endian byte order, where the lower address stores the higher bits of the value, and the higher address stores the lower bits. It is sometimes also called network byte order. LITTLE_ENDIAN: Little-endian byte order, where the lower address stores the lower bits of the value, and the higher address stores the higher bits.

  Zh

  获取当前主机的字节序。 主机字节序，是 CPU 存放数据的两种不同顺序，包括小端字节序和大端字节序。 BIG_ENDIAN：大端字节序，地址低位存储值的高位，地址高位存储值的低位。有时也称之为网络字节序。 LITTLE_ENDIAN：小端字节序，地址低位存储值的低位，地址高位存储值的高位。