Служба дескриптора потока должна соответствовать требованиям для службы дескриптора, а также дополнительным требованиям, перечисленным ниже.
В приведенной ниже таблице<X>обозначает класс обслуживания дескриптора потока,<a>обозначает значение типа<X>,<b>обозначает значение типа<X::implementation_type>,<ec>обозначает значение типа<error_code>,<mb>обозначает значение, удовлетворяющее требованиямизменчивой буферной последовательности,<rh>обозначает значение, удовлетворяющее требованиям<ReadHandler>,<cb>обозначает значение, удовлетворяющее требованиямпостоянной буферной последовательности, а<wh>обозначает значение, удовлетворяющее требованиям<WriteHandler>.
Table 31. StreamDescriptorService 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>
.
Статья Stream descriptor service requirements раздела Boost.Asio Reference может быть полезна для разработчиков на c++ и boost.
Материалы статей собраны из открытых источников, владелец сайта не претендует на авторство. Там где авторство установить не удалось, материал подаётся без имени автора. В случае если Вы считаете, что Ваши права нарушены, пожалуйста, свяжитесь с владельцем сайта.