ParsableByteArray

public byte[] data

public int position

public ParsableByteArray()

Creates a new instance that initially has no backing data.

public ParsableByteArray(byte[] data)

Creates a new instance wrapping data, and sets the limit to data.length.

public ParsableByteArray(int limit)

Creates a new instance with limit bytes and sets the limit.

public ParsableByteArray(byte[] data, int limit)

Creates a new instance that wraps an existing array.

public int bytesLeft()

Returns the number of bytes yet to be read.

public int capacity()

Returns the capacity of the array, which may be larger than the limit.

public void ensureCapacity(int requiredCapacity)

Ensures the backing array is at least requiredCapacity long.

position, limit, and all data in the underlying array (including that beyond limit) are preserved.

This might replace or wipe the underlying array, potentially invalidating any local references.

public byte[] getData()

Returns the underlying array.

Changes to this array are reflected in the results of the read...() methods.

This reference must be assumed to become invalid when reset or ensureCapacity are called (because the array might get reallocated).

public int getPosition()

Returns the current offset in the array, in bytes.

public int limit()

Returns the limit.

public char peekChar()

Peeks at the next char.

Equivalent to passing UTF_16 or UTF_16BE to peekChar.

public char peekChar(Charset charset)

Peeks at the next char (as decoded by charset)

public int peekUnsignedByte()

Peeks at the next byte as an unsigned value.

public void readBytes(ParsableBitArray bitArray, int length)

Reads the next length bytes into bitArray, and resets the position of bitArray to zero.

public void readBytes(ByteBuffer buffer, int length)

Reads the next length bytes into buffer.

public void readBytes(byte[] buffer, int offset, int length)

Reads the next length bytes into buffer at offset.

public @Nullable String readDelimiterTerminatedString(char delimiter)

Reads up to the next delimiter byte (or the limit) as UTF-8 characters.

public double readDouble()

Reads the next eight bytes as a 64-bit floating point value.

public float readFloat()

Reads the next four bytes as a 32-bit floating point value.

public int readInt()

Reads the next four bytes as a signed value

public int readInt24()

Reads the next three bytes as a signed value.

public @Nullable String readLine()

Reads a line of text in UTF-8.

Equivalent to passing UTF_8 to readLine.

public @Nullable String readLine(Charset charset)

Reads a line of text in charset.

A line is considered to be terminated by any one of a carriage return ('\r'), a line feed ('\n'), or a carriage return followed immediately by a line feed ('\r\n'). This method discards leading UTF byte order marks (BOM), if present.

The position is advanced to start of the next line (i.e. any line terminators are skipped).

public int readLittleEndianInt()

Reads the next four bytes as a signed value in little endian order.

public int readLittleEndianInt24()

Reads the next three bytes as a signed value in little endian order.

public long readLittleEndianLong()

Reads the next eight bytes as a signed value in little endian order.

public short readLittleEndianShort()

Reads the next two bytes as a signed value.

public long readLittleEndianUnsignedInt()

Reads the next four bytes as an unsigned value in little endian order.

public int readLittleEndianUnsignedInt24()

Reads the next three bytes as an unsigned value in little endian order.

public int readLittleEndianUnsignedIntToInt()

Reads the next four bytes as a little endian unsigned integer into an integer, if the top bit is a zero.

public int readLittleEndianUnsignedShort()

Reads the next two bytes as an unsigned value.

public long readLong()

Reads the next eight bytes as a signed value.

public @Nullable String readNullTerminatedString()

Reads up to the next NUL byte (or the limit) as UTF-8 characters.

public String readNullTerminatedString(int length)

Reads the next length bytes as UTF-8 characters. A terminating NUL byte is discarded, if present.

public short readShort()

Reads the next two bytes as a signed value.

public String readString(int length)

Reads the next length bytes as UTF-8 characters.

public String readString(int length, Charset charset)

Reads the next length bytes as characters in the specified Charset.

public int readSynchSafeInt()

Reads a Synchsafe integer.

Synchsafe integers keep the highest bit of every byte zeroed. A 32 bit synchsafe integer can store 28 bits of information.

public int readUnsignedByte()

Reads the next byte as an unsigned value.

public int readUnsignedFixedPoint1616()

Reads the next four bytes, returning the integer portion of the fixed point 16.16 integer.

public long readUnsignedInt()

Reads the next four bytes as an unsigned value.

public int readUnsignedInt24()

Reads the next three bytes as an unsigned value.

public int readUnsignedIntToInt()

Reads the next four bytes as an unsigned integer into an integer, if the top bit is a zero.

public long readUnsignedLongToLong()

Reads the next eight bytes as an unsigned long into a long, if the top bit is a zero.

public int readUnsignedShort()

Reads the next two bytes as an unsigned value.

public long readUtf8EncodedLong()

Reads a long value encoded by UTF-8 encoding

public @Nullable Charset readUtfCharsetFromBom()

Reads a UTF byte order mark (BOM) and returns the UTF Charset it represents. Returns null without advancing position if no BOM is found.

public void reset(byte[] data)

Updates the instance to wrap data, and resets the position to zero and the limit to data.length.

public void reset(int limit)

Resets the position to zero and the limit to the specified value. This might replace or wipe the underlying array, potentially invalidating any local references.

public void reset(byte[] data, int limit)

Updates the instance to wrap data, and resets the position to zero.

public void setLimit(int limit)

Sets the limit.

public void setPosition(int position)

Sets the reading offset in the array.

public void skipBytes(int bytes)

Moves the reading offset by bytes.