Интерфейс GatheringByteChannel

Производится попытка записать до r байтов в этот канал, где r — общее количество байтов, оставшихся в указанной подпоследовательности заданного массива буферов, т. е.,

    srcs[offset].remaining()
        + srcs[offset+1].remaining()
        + ... + srcs[offset+length-1].remaining()

Предположим, что записывается последовательность байтов длиной n, где 0 <= n <= r. До srcs[offset].remaining() байтов этой последовательности записываются из буфера srcs[offset], до следующих srcs[offset+1].remaining() байтов записываются из буфера srcs[offset+1], и так далее, пока вся последовательность байтов не будет записана. Максимально возможное количество байтов записывается из каждого буфера, поэтому конечная позиция каждого обновленного буфера, кроме последнего обновленного буфера, гарантированно равна пределу этого буфера.

Если не указано иное, операция записи завершится только после записи всех r запрошенных байтов. Некоторые типы каналов в зависимости от своего состояния могут записать только некоторые байты или, возможно, вообще не записать. Например, сокетный канал в режиме без ожидания не может записать больше байтов, чем свободны в выходном буфере сокета.

Этот метод можно вызвать в любое время. Однако, если другой поток уже инициировал операцию записи в этот канал, вызов этого метода будет заблокирован до завершения первой операции.

Вызов этого метода в виде c.write(srcs) ведет себя точно так же, как вызов

    c.write(srcs, 0, srcs.length);