abstract suspend fun peekTo(
offset: Long = 0,
min: Long = 1,
max: Long = Long.MAX_VALUE
Try to copy at least min but up to max bytes to the specified destination buffer from this input
skipping offset bytes. If there are not enough bytes available to provide min bytes after skipping offset
bytes then it will trigger the underlying source reading first and after that will
simply copy available bytes even if EOF encountered so min is not a requirement but a desired number of bytes.
It is safe to specify max greater than the destination free space.
min shouldn’t be bigger than the destination free space.
This function could trigger the underlying source suspending reading.
It is allowed to specify too big offset so in this case this function will always return
0 after prefetching
all underlying bytes but note that it may lead to significant memory consumption.
This function usually copy more bytes than min (unless
max = min) but it is not guaranteed.
0 is returned with
offset = 0 then it makes sense to check isClosedForRead.
destination - to write bytes
offset - to skip input
min - bytes to be copied, shouldn’t be greater than the buffer free space. Could be
max - bytes to be copied even if there are more bytes buffered, could be Int.MAX_VALUE.
number of bytes copied to the destination possibly