InputByteStreamRef::read - История изменений

Андрей Чусов в 04:44, 25 августа 2019

2019-08-25T04:44:55Z

← Предыдущая		Версия 14:44, 25 августа 2019
Строка 33:		Строка 33:
	В отличие от метода [[InputByteStreamRef::read\|read]] метод [[InputByteStreamRef::read_as\|read_as]] по умолчанию использует политику <source lang="cpp" inline>reading_policy_flags::force_fill_buffer</source>.		В отличие от метода [[InputByteStreamRef::read\|read]] метод [[InputByteStreamRef::read_as\|read_as]] по умолчанию использует политику <source lang="cpp" inline>reading_policy_flags::force_fill_buffer</source>.

	Пример: чтение из потока с заполнением буфера полностью и с использованием сигнализации об ошибках чтения с помощью кода завершения.		{{InputByteStreamRef::read example}}
	~~<source lang="cpp">~~
	~~#include <tuple>~~
	~~#include <cstdint>~~
	~~#include <camaas/istream.h>~~

	~~std::uint32_t read_dword(CAMaaS::~~InputByteStreamRef ~~is)~~
	{
	~~std~~::~~uint32_t result;~~
	~~return_code_t err;~~
	~~std::tie(err, std::ignore) = is.~~read~~(&result, sizeof(result), reading_policy<~~
	~~reading_policy_flags::force_fill_buffer, reading_policy_flags::get_error_code>());~~
	~~if (ChsvFailed(err))~~
	~~return std::uint32_t(-1);~~
	~~return result;~~
	}
	~~</source>~~

Андрей Чусов: Правка интерфейса, коммит a7640af1

2019-05-30T02:20:49Z

Правка интерфейса, коммит a7640af1

← Предыдущая		Версия 12:20, 30 мая 2019
Строка 1:		Строка 1:
	{{function_begin \|std::size_t read(void* pBuffer, std::size_t cbBuffer) ~~const~~; /1/		{{function_begin \|std::size_t read(void* pBuffer, std::size_t cbBuffer); /1/
	template <class ReadingPolicy>		template <class ReadingPolicy>
	/см. ниже/ read(void* pBuffer, std::size_t cbBuffer, ReadingPolicy) ~~const~~; /2/ \|{{InputByteStreamRef::read brief}}}}		/см. ниже/ read(void* pBuffer, std::size_t cbBuffer, ReadingPolicy); /2/ \|{{InputByteStreamRef::read brief}}}}
	{{function template paramlist begin}}		{{function template paramlist begin}}
	{{function template paramlist add\|ReadingPolicy\|Вычисляемый дедукцией тип политики чтения, используемой перегрузкой 2. Тип должен определять статическую константу компиляции <tt>value</tt>, содержащую битовую маску идентификаторов компонент политики. Эти идентификаторы заданы перечислением [[reading_policy_flags]] и имеют следующие значения.		{{function template paramlist add\|ReadingPolicy\|Вычисляемый дедукцией тип политики чтения, используемой перегрузкой 2. Тип должен определять статическую константу компиляции <tt>value</tt>, содержащую битовую маску идентификаторов компонент политики. Эти идентификаторы заданы перечислением [[reading_policy_flags]] и имеют следующие значения.

Андрей Чусов в 04:58, 29 мая 2019

2019-05-29T04:58:03Z

← Предыдущая		Версия 14:58, 29 мая 2019
Строка 18:		Строка 18:
	{{function_sa_add\|[[InputByteStreamRef::read_all_as]]}}		{{function_sa_add\|[[InputByteStreamRef::read_all_as]]}}
	{{function_sa_end}}		{{function_sa_end}}
			{{function_end}}

	Если чтение блокирует вызывающий поток выполнения, и эта блокировка прерывается нормальным образом (например, когда поток осуществляет чтение из интернет канала, и другой поток вызывает метод [[IInternetConnectionEndPoint::CancelOperations]] над этим каналом, или по TCP каналу связи поступает сигнал <tt>[https://tools.ietf.org/html/rfc793#page-15 FIN])</tt>), перегрузка 2, в зависимости от значения флага политики <source lang="cpp" inline> reading_policy_flags::get_error_code</source>, возвращает код успешного завершения [https://www.chusov.org/doxygen/group___error_handling.html#CHSVCODES CHSVERROR_SUCCESS_CANCELLED] (0x2417000f) или генерирует исключение [https://www.chusov.org/doxygen/struct_chusov_1_1_exceptions_1_1_operation_cancelled_exception.html Chusov::Exceptions::OperationCancelledException]. Перегрузка 1 в таких случаях всегда генерирует это исключение.		Если чтение блокирует вызывающий поток выполнения, и эта блокировка прерывается нормальным образом (например, когда поток осуществляет чтение из интернет канала, и другой поток вызывает метод [[IInternetConnectionEndPoint::CancelOperations]] над этим каналом, или по TCP каналу связи поступает сигнал <tt>[https://tools.ietf.org/html/rfc793#page-15 FIN])</tt>), перегрузка 2, в зависимости от значения флага политики <source lang="cpp" inline> reading_policy_flags::get_error_code</source>, возвращает код успешного завершения [https://www.chusov.org/doxygen/group___error_handling.html#CHSVCODES CHSVERROR_SUCCESS_CANCELLED] (0x2417000f) или генерирует исключение [https://www.chusov.org/doxygen/struct_chusov_1_1_exceptions_1_1_operation_cancelled_exception.html Chusov::Exceptions::OperationCancelledException]. Перегрузка 1 в таких случаях всегда генерирует это исключение.

Андрей Чусов в 04:08, 29 мая 2019

2019-05-29T04:08:40Z

← Предыдущая		Версия 14:08, 29 мая 2019
Строка 44:		Строка 44:
	std::tie(err, std::ignore) = is.read(&result, sizeof(result), reading_policy<		std::tie(err, std::ignore) = is.read(&result, sizeof(result), reading_policy<
	reading_policy_flags::force_fill_buffer, reading_policy_flags::get_error_code>());		reading_policy_flags::force_fill_buffer, reading_policy_flags::get_error_code>());
			if (ChsvFailed(err))
			return std::uint32_t(-1);
	return result;		return result;
	}		}
	</source>		</source>

Андрей Чусов в 04:00, 29 мая 2019

2019-05-29T04:00:36Z

← Предыдущая		Версия 14:00, 29 мая 2019
Строка 30:		Строка 30:
	</source>		</source>

	В отличие от метода [[InputByteStreamRef::read\|read]] ~~методы~~ [[InputByteStreamRef::read_as\|read_as~~]] и [[InputByteStreamRef::read_all_as\|read_all_as~~]] по умолчанию ~~используют~~ политику <source lang="cpp" inline>reading_policy_flags::force_fill_buffer</source>.		В отличие от метода [[InputByteStreamRef::read\|read]] метод [[InputByteStreamRef::read_as\|read_as]] по умолчанию использует политику <source lang="cpp" inline>reading_policy_flags::force_fill_buffer</source>.

	Пример: чтение из потока с заполнением буфера полностью и с использованием сигнализации об ошибках чтения с помощью кода завершения.		Пример: чтение из потока с заполнением буфера полностью и с использованием сигнализации об ошибках чтения с помощью кода завершения.

Андрей Чусов в 03:53, 29 мая 2019

2019-05-29T03:53:48Z

← Предыдущая		Версия 13:53, 29 мая 2019
Строка 19:		Строка 19:
	{{function_sa_end}}		{{function_sa_end}}

	Если чтение блокирует вызывающий поток выполнения, и эта блокировка прерывается нормальным образом (например, когда поток осуществляет чтение из интернет канала, и другой поток вызывает метод [[IInternetConnectionEndPoint::CancelOperations]] над этим каналом, или по TCP каналу связи поступает сигнал <tt>[https://tools.ietf.org/html/rfc793#page-15 FIN])</tt>), перегрузка 2, в зависимости от значения флага политики <source lang="cpp" inline> reading_policy_flags::get_error_code</source>, возвращает код успешного завершения [https://www.chusov.org/doxygen/group___error_handling.html#CHSVCODES CHSVERROR_SUCCESS_CANCELLED] (0x2417000f) или генерирует исключение [https://www.chusov.org/doxygen/struct_chusov_1_1_exceptions_1_1_operation_cancelled_exception.html Chusov::Exceptions::OperationCancelledException].		Если чтение блокирует вызывающий поток выполнения, и эта блокировка прерывается нормальным образом (например, когда поток осуществляет чтение из интернет канала, и другой поток вызывает метод [[IInternetConnectionEndPoint::CancelOperations]] над этим каналом, или по TCP каналу связи поступает сигнал <tt>[https://tools.ietf.org/html/rfc793#page-15 FIN])</tt>), перегрузка 2, в зависимости от значения флага политики <source lang="cpp" inline> reading_policy_flags::get_error_code</source>, возвращает код успешного завершения [https://www.chusov.org/doxygen/group___error_handling.html#CHSVCODES CHSVERROR_SUCCESS_CANCELLED] (0x2417000f) или генерирует исключение [https://www.chusov.org/doxygen/struct_chusov_1_1_exceptions_1_1_operation_cancelled_exception.html Chusov::Exceptions::OperationCancelledException]. Перегрузка 1 в таких случаях всегда генерирует это исключение.

	Пусть <tt>is</tt> - объект класса [[InputByteStreamRef]]. Тогда вызов перегрузки 1		Пусть <tt>is</tt> - объект класса [[InputByteStreamRef]]. Тогда вызов перегрузки 1

Андрей Чусов в 03:39, 29 мая 2019

2019-05-29T03:39:56Z

← Предыдущая		Версия 13:39, 29 мая 2019
Строка 15:		Строка 15:
	{{function_sa_begin}}		{{function_sa_begin}}
	{{function_sa_add\|[[IInputByteStream::ReadArray]]}}		{{function_sa_add\|[[IInputByteStream::ReadArray]]}}
			{{function_sa_add\|[[InputByteStreamRef::read_as]]}}
			{{function_sa_add\|[[InputByteStreamRef::read_all_as]]}}
	{{function_sa_end}}		{{function_sa_end}}

Строка 27:		Строка 29:
	is.read(pBuf, cbBuf, reading_policy<>());		is.read(pBuf, cbBuf, reading_policy<>());
	</source>		</source>

			В отличие от метода [[InputByteStreamRef::read\|read]] методы [[InputByteStreamRef::read_as\|read_as]] и [[InputByteStreamRef::read_all_as\|read_all_as]] по умолчанию используют политику <source lang="cpp" inline>reading_policy_flags::force_fill_buffer</source>.

	Пример: чтение из потока с заполнением буфера полностью и с использованием сигнализации об ошибках чтения с помощью кода завершения.		Пример: чтение из потока с заполнением буфера полностью и с использованием сигнализации об ошибках чтения с помощью кода завершения.

Андрей Чусов в 03:19, 29 мая 2019

2019-05-29T03:19:11Z

@@ Строка 1: / Строка 1: @@
-{{function_begin |std::size_t read(_Out_bytecap_post_bytecount_(cbBuffer, return) void* pBuffer, std::size_t cbBuffer); |{{IInternetConnectionEndPoint::read brief}}}}
+{{function_begin |std::size_t read(void* pBuffer, std::size_t cbBuffer) const; /*1*/
 {{function_paramlist begin}}
-{{function_paramlist add|pBuffer|Указатель, который в случае успешного завершения функции принимает считанные данные. Объем считанных данных возвращается методом.|paramdir=[out]}}
+{{function_paramlist add|pBuffer|Указатель, который в случае успешного завершения функции принимает считанные данные. Объем считанных данных возвращается, прямо или опосредовано через пару, методами.|paramdir=[out]}}
 {{function_paramlist add|cbBuffer|Размер буфера в байтах.}}
 {{function_paramlist end}}
-{{function_return_value|Объем прочитанных данных.}}
+{{function_return_value|Перегрузка 1 возвращает объем прочитанных данных. Тип значения, возвращаемого перегрузкой 2, зависит от политики <tt>ReadingPolicy</tt>. Если политикой не указан флаг <source lang="cpp" inline>reading_policy_flags::get_error_code</source>, перегрузка 2 возвращает объем считанных данных аналогично перегрузке 1. Если флаг <source lang="cpp" inline>reading_policy_flags::get_error_code</source> установлен, возвращается пара [https://en.cppreference.com/w/cpp/utility/pair std::pair] значений <source lang="cpp" inline>std::pair<return_code_t, std::size_t></source> - код завершения чтения в качестве первого элемента пары, и объем считанных байт - в качестве второго.}}
 {{function_sa_begin}}
 {{function_sa_add|[[IInputByteStream::ReadArray]]}}
 {{function_sa_end}}
-Любая блокировка потоков выполнения, осуществляющих коммуникацию, может быть прервана вызовом метода [[IInternetConnectionEndPoint::CancelOperations]]. В этом случае блокирующие поток методы возвращают код [https://www.chusov.org/doxygen/group___error_handling.html#CHSVCODES CHSVERROR_SUCCESS_CANCELLED] (0x2417000f).}}
+Если чтение блокирует вызывающий поток выполнения, и эта блокировка прерывается нормальным образом (например, когда поток осуществляет чтение из интернет канала, и другой поток вызывает метод [[IInternetConnectionEndPoint::CancelOperations]] над этим каналом, или по TCP каналу связи поступает сигнал <tt>[https://tools.ietf.org/html/rfc793#page-15 FIN])</tt>), перегрузка 2, в зависимости от значения флага политики <source lang="cpp" inline> reading_policy_flags::get_error_code</source>, возвращает код успешного завершения [https://www.chusov.org/doxygen/group___error_handling.html#CHSVCODES CHSVERROR_SUCCESS_CANCELLED] (0x2417000f) или генерирует исключение [https://www.chusov.org/doxygen/struct_chusov_1_1_exceptions_1_1_operation_cancelled_exception.html Chusov::Exceptions::OperationCancelledException].
-{{function_end}}

Андрей Чусов в 04:51, 23 мая 2019

2019-05-23T04:51:32Z

← Предыдущая		Версия 14:51, 23 мая 2019
Строка 9:		Строка 9:
	{{function_sa_end}}		{{function_sa_end}}

	Любая блокировка потоков выполнения, осуществляющих коммуникацию, может быть прервана вызовом метода [[~~InternetConnectionEndPoint~~::CancelOperations]]. В этом случае блокирующие поток методы возвращают код [https://www.chusov.org/doxygen/group___error_handling.html#CHSVCODES CHSVERROR_SUCCESS_CANCELLED] (0x2417000f).}}		Любая блокировка потоков выполнения, осуществляющих коммуникацию, может быть прервана вызовом метода [[IInternetConnectionEndPoint::CancelOperations]]. В этом случае блокирующие поток методы возвращают код [https://www.chusov.org/doxygen/group___error_handling.html#CHSVCODES CHSVERROR_SUCCESS_CANCELLED] (0x2417000f).}}
	{{function_end}}		{{function_end}}

Андрей Чусов: Восстановление потерянной информации

2018-07-05T04:19:22Z

Восстановление потерянной информации

← Предыдущая		Версия 14:19, 5 июля 2018
Строка 1:		Строка 1:
	{{function_begin \|std::size_t read(_Out_bytecap_post_bytecount_(cbBuffer, return) void* pBuffer, std::size_t cbBuffer) ~~const~~; \|{{IInternetConnectionEndPoint::read brief}}}}		{{function_begin \|std::size_t read(_Out_bytecap_post_bytecount_(cbBuffer, return) void* pBuffer, std::size_t cbBuffer); \|{{IInternetConnectionEndPoint::read brief}}}}
	{{function_paramlist begin}}		{{function_paramlist begin}}
	{{function_paramlist add\|pBuffer\|Указатель, который в случае успешного завершения функции принимает считанные данные. Объем считанных данных возвращается методом.\|paramdir=[out]}}		{{function_paramlist add\|pBuffer\|Указатель, который в случае успешного завершения функции принимает считанные данные. Объем считанных данных возвращается методом.\|paramdir=[out]}}