Служба управления случайным доступом должна соответствовать требованиям для службы управления, а также дополнительным требованиям, перечисленным ниже.
В приведенной ниже таблице<X>обозначает класс обслуживания ручек случайного доступа,<a>обозначает значение типа<X>,<b>обозначает значение типа<X::implementation_type>,<ec>обозначает значение типа<error_code>,<o>обозначает смещение наддува типа::uint64_t,<mb>обозначает значение, удовлетворяющее требованиямизменчивой буферной последовательности,<rh>обозначает значение, удовлетворяющее требованиям<ReadHandler>,<cb>обозначает значение, удовлетворяющее требованиямпостоянной буферной последовательности, а<wh>обозначает значение, удовлетворяющее требованиям<WriteHandler>.
Table 21. RandomAccessHandleService requirements
выражение
Тип возврата
утверждение/примечание до/после условия
<a.read_some_at(b,o,mb,ec);>
<size_t>
pre:<a.is_open(b)>.
Считывает один или несколько байтов данных с ручки<b>при смещении<o>.
Изменяемая буферная последовательность<mb>определяет память, в которой должны быть размещены данные. Операция должна всегда полностью заполнять буфер в последовательности перед переходом к следующей.
В случае успеха возвращает количество прочитанных байтов. В противном случае<0>. Если общий размер всех буферов в последовательности<mb>равен<0>, то функция возвращается<0>немедленно.
<a.async_read_some_at(b,o,mb,rh);>
<void>
pre:<a.is_open(b)>.
Инициирует асинхронную операцию для считывания одного или нескольких байтов данных от ручки<b>при смещении<o>. Операция выполняется через<io_service>объект<a.get_io_service()>и ведет себя в соответствии стребованиями асинхронной операции.
Изменяемая буферная последовательность<mb>определяет память, в которой должны быть размещены данные. Операция должна всегда полностью заполнять буфер в последовательности перед переходом к следующей.
Реализация должна поддерживать одну или более копий<mb>до тех пор, пока операция чтения больше не потребует доступа к памяти, указанной буферами в последовательности. Программа должна гарантировать, что память действительна до тех пор, пока:
& #8212; последняя копия<mb>не будет уничтожена, или
& #8212; не будет задействован обработчик асинхронной операции,
в зависимости от того, что наступит раньше. Если общий размер всех буферов в последовательности<mb>равен<0>, операция асинхронного считывания должна быть завершена немедленно и передана<0>в качестве аргумента обработчику, который определяет количество считанных байтов.
Если операция завершается успешно,<ReadHandler>объект<rh>вызывается с числом переданных байтов. В противном случае он ссылается на<0>
.
<a.write_some_at(b,o,cb,ec);>
<size_t>
pre:<a.is_open(b)>.
Записывает один или несколько байтов данных в ручку<b>при смещении<o>.
Постоянная буферная последовательность<cb>определяет память, в которой находятся записываемые данные. Операция должна всегда полностью записывать буфер в последовательности перед переходом к следующей.
В случае успеха возвращает количество байтов, написанных. В противном случае<0>. Если суммарный размер всех буферов в последовательности<cb>равен<0>, функция возвращается<0>немедленно.
<a.async_write_some_at(b,o,cb,wh);>
<void>
Пред:<a.is_open(b)>
Инициирует асинхронную операцию записи одного или более байтов данных в ручку<b>при смещении<o>. Операция выполняется через<io_service>объект<a.get_io_service()>и ведет себя в соответствии стребованиями асинхронной операции.
Постоянная буферная последовательность<cb>определяет память, в которой находятся записываемые данные. Операция должна всегда полностью записывать буфер в последовательности перед переходом к следующей.
Реализация должна поддерживать одну или несколько копий<cb>до тех пор, пока операция записи больше не потребует доступа к памяти, указанной буферами в последовательности. Программа должна гарантировать, что память действительна до тех пор, пока:
& #8212; последняя копия<cb>не будет уничтожена, или
& #8212; не будет задействован обработчик асинхронной операции
в зависимости от того, что наступит раньше. Если общий размер всех буферов в последовательности<cb>равен<0>, то асинхронная операция должна быть выполнена немедленно и передана<0>в качестве аргумента обработчику, который указывает число прочитанных байтов.
Если операция завершается успешно, то<WriteHandler>объект<wh>вызывается с количеством переданных байтов. В противном случае он вызывается<0>
.
Статья Random access handle service requirements раздела Boost.Asio Reference может быть полезна для разработчиков на c++ и boost.
Материалы статей собраны из открытых источников, владелец сайта не претендует на авторство. Там где авторство установить не удалось, материал подаётся без имени автора. В случае если Вы считаете, что Ваши права нарушены, пожалуйста, свяжитесь с владельцем сайта.