get_chunk


Description:

public Buffer? get_chunk (int64 offset)

Gets a Buffer containing data from this starting at offset.

The size of the returned chunk is unspecified. You can iterate through the entire body by first calling get_chunk with an offset of 0, and then on each successive call, increment the offset by the length of the previously-returned chunk.

If offset is greater than or equal to the total length of this, then the return value depends on whether or not complete has been called or not; if it has, then get_chunk will return a 0-length chunk (indicating the end of this). If it has not, then get_chunk will return null (indicating that this may still potentially have more data, but that data is not currently available).

Parameters:

this

a MessageBody

offset

an offset

Returns:

a Buffer, or null.