go: почему Read() не обязан заполнить весь буфер

Представим, что нам нужно прочитать 1024 байта из io.Reader. Пишем:

buf := make([]byte, 1024) n, err := reader.Read(buf) if err != nil { return err } process(buf)

Выглядит вполне логично. Но есть нюанс.

Интерфейс io.Reader не гарантирует, что один вызов Read() заполнит весь буфер.

Например, он вполне может вернуть: n = 256 err = nil Хотя мы запросили 1024 байта.

Это нормальное поведение.

Read() возвращает количество фактически прочитанных байт. И он может прочитать меньше, чем мы запросили, без какой-либо ошибки.

Есть ещё один момент, о котором легко забыть.

Вызов может одновременно вернуть: n > 0 err != nil

В таком случае сначала нужно обработать уже полученные байты, а затем разбираться с ошибкой.

А если нужно прочитать определённое количество байт?

Для этого в Go есть io.ReadFull: buf := make([]byte, 1024) n, err := io.ReadFull(reader, buf) if err != nil { return err } process(buf[:n])

io.ReadFull продолжает читать, пока буфер не заполнится или не возникнет ошибка. Если источник достигнет EOF, не успев передать все запрошенные байты, функция вернёт io.ErrUnexpectedEOF.

Но это не универсальная замена обычному Read(). io.ReadFull подходит, когда заранее известно, сколько байт нужно получить.

Например, при чтении потока произвольной длины обычно нужен другой подход. А вы учитываете это поведение при работе с io.Reader?