readAvailable

abstract suspend fun readAvailable(
    dst: ByteArray,
    offset: Int,
    length: Int
): Int

Reads all available bytes to dst buffer and returns immediately or suspends if no bytes available

Return number of bytes were read or -1 if the channel has been closed

abstract suspend fun readAvailable(dst: IoBuffer): Int
abstract suspend fun readAvailable(dst: ByteBuffer): Int
abstract fun readAvailable(
    min: Int = 1,
    block: (ByteBuffer) -> Unit
): Int

Invokes block if it is possible to read at least min byte providing byte buffer to it so lambda can read from the buffer up to ByteBuffer.available bytes. If there are no min bytes available then the invocation returns 0.

Warning: it is not guaranteed that all of available bytes will be represented as a single byte buffer eg: it could be 4 bytes available for read but the provided byte buffer could have only 2 available bytes: in this case you have to invoke read again (with decreased min accordingly).

Parameters

min - amount of bytes available for read, should be positive

block - to be invoked when at least min bytes available

Return number of consumed bytes or -1 if the block wasn’t executed.