Описание пакета io языка программирования Go
Categories:
Его основная задача - обернуть существующие реализации таких примитивов, например, в пакете os, в общие публичные интерфейсы, которые абстрагируют эту функциональность, а также некоторые другие связанные с ней примитивы.
Поскольку эти интерфейсы и примитивы обертывают операции нижнего уровня с различными реализациями, если клиенты не проинформированы об ином, не следует полагать, что они безопасны для параллельного выполнения.
Константы
const (
SeekStart = 0 // поиск относительно начала файла
SeekCurrent = 1 // поиск относительно текущего смещения
SeekEnd = 2 // поиск относительно конца)
Значения whence поиска.
Переменные
var EOF = errors.New(«EOF»)
EOF — это ошибка, возвращаемая Read, когда входные данные больше не доступны. (Read должен возвращать сам EOF, а не ошибку, оборачивающую EOF, потому что вызывающие функции будут проверять EOF с помощью ==.) Функции должны возвращать EOF только для сигнализации о корректном завершении ввода. Если EOF возникает неожиданно в структурированном потоке данных, соответствующей ошибкой является либо ErrUnexpectedEOF, либо какая-либо другая ошибка, дающая более подробную информацию.
var ErrClosedPipe = errors.New(«io: read/write on closed pipe»)
ErrClosedPipe — это ошибка, используемая для операций чтения или записи в закрытом канале.
var ErrNoProgress = errors.New(«multiple Read calls return no data or error»)
ErrNoProgress возвращается некоторыми клиентами Reader, когда много вызовов Read не возвращают никаких данных или ошибок, что обычно является признаком неисправной реализации Reader.
var ErrShortBuffer = errors.New(«короткий буфер»)
ErrShortBuffer означает, что для чтения потребовался буфер большего размера, чем был предоставлен.
var ErrShortWrite = errors.New(«короткая запись»)
ErrShortWrite означает, что запись приняла меньше байтов, чем было запрошено, но не вернула явную ошибку.
var ErrUnexpectedEOF = errors.New(«неожиданный EOF»)
ErrUnexpectedEOF означает, что EOF был обнаружен в середине чтения блока фиксированного размера или структуры данных.
