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

Stream 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>,<mb>обозначает значение, удовлетворяющее требованиямизменчивой буферной последовательности,<rh>обозначает значение, удовлетворяющее требованиям<ReadHandler>,<cb>обозначает значение, удовлетворяющее требованиямпостоянной буферной последовательности, а<wh>обозначает значение, удовлетворяющее требованиям<WriteHandler>.

Table 32. StreamHandleService requirements

выражение

Тип возврата

утверждение/примечание
до/после условия

<a.read_some(b, mb, ec);>

<size_t>

Пред:<a.is_open(b)>.

Считывает один или несколько байтов данных с ручки<b>.

Изменяемая буферная последовательность<mb>определяет память, в которой должны быть размещены данные. Операция должна всегда полностью заполнять буфер в последовательности перед переходом к следующей.

В случае успеха возвращает число прочитанных байтов. В обратном случае<0>. Если общий размер всех буферов в последовательности<mb>равен<0>, то функция возвращается<0>немедленно.

Если операция завершается из-за изящного закрытия соединения сверстником, операция должна выйти из строя<error::eof>

.

<a.async_read_some(b, mb, rh);>

<void>

pre:<a.is_open(b)>.

Инициирует асинхронную операцию считывания одного или нескольких байтов данных с ручки<b>. Операция выполняется через<io_service>объект<a.get_io_service()>и ведет себя в соответствии стребованиями асинхронной операции.

Изменяемая буферная последовательность<mb>определяет память, в которой должны быть размещены данные. Операция должна всегда полностью заполнять буфер в последовательности перед переходом к следующей.

Реализация должна поддерживать одну или более копий<mb>до тех пор, пока операция чтения больше не потребует доступа к памяти, указанной буферами в последовательности. Программа должна гарантировать, что память действительна до тех пор, пока:

& #8212; последняя копия<mb>не будет уничтожена, или

& #8212; не будет задействован обработчик асинхронной операции,

в зависимости от того, что наступит раньше. Если общий размер всех буферов в последовательности<mb>равен<0>, операция асинхронного считывания должна быть завершена немедленно и передана<0>в качестве аргумента обработчику, который определяет количество считанных байтов.

Если операция завершается из-за изящного закрытия соединения одноранговым устройством, операция не должна выполняться<error::eof>.

Если операция завершается успешно, то<ReadHandler>объект<rh>вызывается с числом переданных байтов. В противном случае он ссылается на<0>

.

<a.write_some(b, cb, ec);>

<size_t>

pre:<a.is_open(b)>.

Записывает один или несколько байтов данных в ручку<b>.

Постоянная буферная последовательность<cb>определяет память, в которой находятся записываемые данные. Операция должна всегда полностью записывать буфер в последовательности перед переходом к следующей.

В случае успеха возвращает количество написанных байтов. В противном случае<0>. Если суммарный размер всех буферов в последовательности<cb>равен<0>, функция возвращается<0>немедленно.

<a.async_write_some(b, cb, wh);>

<void>

Пред:<a.is_open(b)>

Инициирует асинхронную операцию для записи одного или более байтов данных в ручку<b>. Операция выполняется через<io_service>объект<a.get_io_service()>и ведет себя в соответствии стребованиями асинхронной операции.

Постоянная буферная последовательность<cb>определяет память, в которой находятся записываемые данные. Операция должна всегда полностью записывать буфер в последовательности перед переходом к следующей.

Реализация должна поддерживать одну или несколько копий<cb>до тех пор, пока операция записи больше не потребует доступа к памяти, указанной буферами в последовательности. Программа должна гарантировать, что память действительна до тех пор, пока:

& #8212; последняя копия<cb>не будет уничтожена, или

& #8212; не будет задействован обработчик асинхронной операции

в зависимости от того, что наступит раньше. Если общий размер всех буферов в последовательности<cb>равен<0>, то асинхронная операция должна быть выполнена немедленно и передана<0>в качестве аргумента обработчику, который указывает число прочитанных байтов.

Если операция завершается успешно, то<WriteHandler>объект<wh>вызывается с количеством переданных байтов. В противном случае он вызывается<0>

.


PrevUpHomeNext

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




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



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


реклама


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

Время компиляции файла: 2024-08-30 11:47:00
2025-05-19 21:21:34/0.0072178840637207/0