read_at (4 of 8 overloads) . Boost , Boost.Asio , read_at

read_at (4 of 8 overloads)

Попробуйте прочитать определенное количество данных в указанном смещение перед возвращением.

template<
    typename SyncRandomAccessReadDevice,
    typename MutableBufferSequence,
    typename CompletionCondition>
std::size_t read_at(
    SyncRandomAccessReadDevice & d,
    uint64_t offset,
    const MutableBufferSequence & buffers,
    CompletionCondition completion_condition,
    boost::system::error_code & ec);

Эта функция используется для считывания определенного количества байтов данных с устройства случайного доступа в указанном смещение. Звонок будет блокироваться до тех пор, пока не будет выполнено одно из следующих условий:

Поставляемые буферы заполнены. То есть переданные байты равны сумме буферных размеров.
Объект функции завершения_условия возвращает 0.

Эта операция реализована с точки зрения нуля или более вызовов функции read_some_at устройства.

Parameters

d

Устройство, с которого следует считывать данные. Тип должен поддерживать концепцию SyncRandomAccessReadDevice.

offset

Смещение, при котором будут считаны данные.

buffers

Один или несколько буферов, в которые будут считываться данные. Сумма размеров буфера указывает на максимальное количество байтов для чтения с устройства.

completion_condition

Объект функции должен быть вызван, чтобы определить, завершена ли операция чтения. Подпись объекта функции должна быть:

std::size_t completion_condition(
  // Result of latest read_some_at operation.
  const boost::system::error_code& error,
  // Number of bytes transferred so far.
  std::size_t bytes_transferred
);

Обратное значение 0 означает, что операция чтения завершена. Ненулевое значение возврата указывает на максимальное количество байтов, которые будут считаны при следующем вызове функции read_some_at устройства.

ec

Установить, какая ошибка произошла, если таковая имеется.

Return Value

Количество прочитанных байтов. При возникновении ошибки возвращает общее количество байтов, успешно переданных до ошибки.

Статья read_at (4 of 8 overloads) раздела Boost.Asio read_at может быть полезна для разработчиков на c++ и boost.

read_at (4 of 8 overloads)

Boost , Boost.Asio , read_at

Boost C++ Libraries

read_at (4 of 8 overloads)

Parameters

Return Value