async_write_at (2 of 4 overloads) . Boost , Boost.Asio , async_write_at

async_write_at (2 of 4 overloads)

Начните асинхронную операцию для записи определенного количества данных при указанном смещении.

template<
    typename AsyncRandomAccessWriteDevice,
    typename ConstBufferSequence,
    typename CompletionCondition,
    typename WriteHandler>
void-or-deduced async_write_at(
    AsyncRandomAccessWriteDevice & d,
    uint64_t offset,
    const ConstBufferSequence & buffers,
    CompletionCondition completion_condition,
    WriteHandler handler);

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

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

Эта операция реализована в терминах нуля или более вызовов функции асинхронизации_write_some_at устройства и известна как.. Программа должна гарантировать, что устройство не выполняет операций записи, перекрывающихся(таких как async_write_at, функция async_write_some_at устройства или любые другие составные операции, которые выполняют записи) до завершения этой операции. Операции перекрываются, если области, определенные их смещениями, и числа байтов для записи пересекаются.

Parameters

d

Устройство, на которое должны быть записаны данные. Этот тип должен поддерживать концепцию AsyncRandomAccessWriteDevice.

offset

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

buffers

Один или несколько буферов, содержащих данные, подлежащие записи. Хотя объект буферов может быть скопирован по мере необходимости, право собственности на базовые блоки памяти сохраняется абонентом, который должен гарантировать, что они остаются действительными до тех пор, пока обработчик не будет вызван.

completion_condition

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

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

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

handler

Обработчик должен быть вызван, когда операция записи завершится. Копии будут сделаны из обработчика по мере необходимости. Функциональная подпись обработчика должна быть:

void handler(
  // Result of operation.
  const boost::system::error_code& error,
  // Number of bytes written from the buffers. If an error
  // occurred, this will be less than the sum of the buffer sizes.
  std::size_t bytes_transferred
);

Независимо от того, выполняется ли асинхронная операция немедленно или нет, обработчик не будет вызываться из этой функции. В этом случае он будет выполняться таким же образом, как и<boost::asio::io_service::post()>.

Example

Чтобы написать один буфер данных, используйте<buffer>функционируют следующим образом:

boost::asio::async_write_at(d, 42,
    boost::asio::buffer(data, size),
    boost::asio::transfer_at_least(32),
    handler);

Смотреть<buffer>документация для информации о написании нескольких буферов за один ход, и как использовать его с массивами, бустер::array или std::vector.

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

async_write_at (2 of 4 overloads)

Boost , Boost.Asio , async_write_at

Boost C++ Libraries

async_write_at (2 of 4 overloads)

Parameters

Example