Deno.ReaderSync

Абстрактный интерфейс, который при реализации предоставляет интерфейс для синхронного чтения байтов в буфер массива.

interface ReaderSync {readSync(p: Uint8Array): number | null;
}

Методы

readSync(p: Uint8Array): number | null

Читает до p.byteLength байтов в p. Возвращает количество прочитанных байтов (0 < n <= p.byteLength) и отклоняет, если возникает какая-либо ошибка. Даже если readSync() возвращает n < p.byteLength, оно может использовать все p в качестве рабочей области во время вызова. Если доступны данные, но не p.byteLength байтов, readSync() обычно возвращает доступные данные вместо ожидания дополнительных данных.

Когда readSync() сталкивается с концом файла, он возвращает EOF (null).

Когда readSync() сталкивается с ошибкой, он выбрасывает ошибку.

Вызывающие стороны должны всегда обрабатывать n > 0 возвращенные байты перед рассмотрением EOF (null). Это правильно обрабатывает ошибки ввода-вывода, которые происходят после чтения некоторых байтов, а также оба разрешенных поведения EOF.

Реализации не должны сохранять ссылку на p.

Используйте itereateReaderSync из std/streams/conversion.ts, чтобы преобразовать ReaderSync в {@link Iterator}.