Карта сайта Kansoftware
НОВОСТИУСЛУГИРЕШЕНИЯКОНТАКТЫ
Разработка программного обеспечения

Random access handle service requirements

Boost , Boost.Asio , Reference

Boost C++ Libraries

...one of the most highly regarded and expertly designed C++ library projects in the world. Herb Sutter and Andrei Alexandrescu, C++ Coding Standards

PrevUpHomeNext

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

В приведенной ниже таблице<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>

.


PrevUpHomeNext

Статья Random access handle service requirements раздела Boost.Asio Reference может быть полезна для разработчиков на c++ и boost.




Материалы статей собраны из открытых источников, владелец сайта не претендует на авторство. Там где авторство установить не удалось, материал подаётся без имени автора. В случае если Вы считаете, что Ваши права нарушены, пожалуйста, свяжитесь с владельцем сайта.



:: Главная :: Reference ::


реклама


©KANSoftWare (разработка программного обеспечения, создание программ, создание интерактивных сайтов), 2007
Top.Mail.Ru

Время компиляции файла: 2024-08-30 11:47:00
2025-07-05 06:50:34/0.0043199062347412/0