IBinaryDataBase::RepresentAs - История изменений

Андрей Чусов в 06:23, 16 марта 2017

2017-03-16T06:23:41Z

← Предыдущая		Версия 16:23, 16 марта 2017
Строка 13:		Строка 13:
	Пример:		Пример:

	~~<source lang='cpp'>~~		{{CreateFileAsBinaryDataStorage example}}
	~~char l_filename[] = "./somefile";~~
	~~IIOBinaryData* pIO; //uninitialized pointer~~
	{
	~~IBinaryDataBase* pStorage; //uninitialized pointer~~
	~~int32_t err =~~ CreateFileAsBinaryDataStorage~~(l_filename, sizeof(l_filename), FileRead \| FileWrite, FileCreateAlways, std::addressof(pStorage));~~

	~~if (err < 0)~~
	~~return -1; //failure~~
	~~if (pStorage->IsInterfaceAvailable(IOBinaryDataType) == 1)~~
	~~return 0; //Interface is not available~~
	~~err = pStorage->RepresentAs(IOBinaryDataType, std::addressof(pIO));~~
	~~if (err < 0)~~
	~~return -1; //failure of RepresentAs~~
	}
	~~//access file via pIO...~~
	~~</source>~~

Андрей Чусов в 10:28, 15 марта 2017

2017-03-15T10:28:08Z

← Предыдущая		Версия 20:28, 15 марта 2017
Строка 18:		Строка 18:
	{		{
	IBinaryDataBase* pStorage; //uninitialized pointer		IBinaryDataBase* pStorage; //uninitialized pointer
	int32_t err = CreateFileAsBinaryDataStorage(l_filename, sizeof(l_filename), FileRead \| FileWrite, FileCreateAlways, std::addressof(pStorage)) ~~noexcept~~;		int32_t err = CreateFileAsBinaryDataStorage(l_filename, sizeof(l_filename), FileRead \| FileWrite, FileCreateAlways, std::addressof(pStorage));

	if (err < 0)		if (err < 0)

Андрей Чусов в 09:58, 15 марта 2017

2017-03-15T09:58:01Z

← Предыдущая		Версия 19:58, 15 марта 2017
Строка 1:		Строка 1:
	{{function_begin \| return_code_t RepresentAs(BinaryDataStorageType type_id, void** ppInterface) noexcept; \|{{IBinaryDataBase::RepresentAs brief}}}}		{{function_begin \| return_code_t RepresentAs(BinaryDataStorageType type_id, void** ppInterface) noexcept; \|{{IBinaryDataBase::RepresentAs brief}}}}
	{{function_paramlist begin}}		{{function_paramlist begin}}
	{{function_paramlist add\|type_id\|}}		{{function_paramlist add\|type_id\|32-х битовое целое, принимающее одно из следующих значений идентификаторов интерфейсов. {{BinaryDataStorageType}}}}
	{{function_paramlist add\|ppInterface\|.\|paramdir=[out]}}		{{function_paramlist add\|ppInterface\|Выходной указатель, принимающий интерфейс заданного типа или 0 в случае ошибки.\|paramdir=[out]}}
	{{function_paramlist end}}		{{function_paramlist end}}
	{{function_return_value\|32-битовый ~~беззнаковый~~ целый код ошибки, который в случае успешного выполнения ~~равен 0~~.}}		{{function_return_value\|32-битовый целый код ошибки, который в случае успешного выполнения неотрицателен (старший бит сброшен). В случае, если интерфейс, заданный идентификатором, не поддерживается, возвращается код [https://www.chusov.org/doxygen/group___error_handling.html CHSVERROR_INVALID_PARAMETER].}}
	{{function_end}}		{{function_end}}

	~~Идентификаторы интерфейсов~~:		В случае успешного завершения функции, полученный через параметр <tt>ppInterface</tt> объект необходимо закрывать вызовом его метода [[InterfaceBase::Release\|Release]] отдельно и независимо от объекта, над которым применен метод [[IBinaryDataBase::RepresentAs\|RepresentAs]].

	{~~{BinaryDataStorageType}~~}		Для проверки доступности того или иного интерфейса предпочтительно использовать метод [[IBinaryDataBase::IsInterfaceAvailable]].

			Пример:

			<source lang='cpp'>
			char l_filename[] = "./somefile";
			IIOBinaryData* pIO; //uninitialized pointer
			{
			IBinaryDataBase* pStorage; //uninitialized pointer
			int32_t err = CreateFileAsBinaryDataStorage(l_filename, sizeof(l_filename), FileRead \| FileWrite, FileCreateAlways, std::addressof(pStorage)) noexcept;

			if (err < 0)
			return -1; //failure
			if (pStorage->IsInterfaceAvailable(IOBinaryDataType) == 1)
			return 0; //Interface is not available
			err = pStorage->RepresentAs(IOBinaryDataType, std::addressof(pIO));
			if (err < 0)
			return -1; //failure of RepresentAs
			}
			//access file via pIO...
			</source>

Ninok2801 в 03:24, 14 марта 2017

2017-03-14T03:24:58Z

← Предыдущая		Версия 13:24, 14 марта 2017
Строка 6:		Строка 6:
	{{function_return_value\|32-битовый беззнаковый целый код ошибки, который в случае успешного выполнения равен 0.}}		{{function_return_value\|32-битовый беззнаковый целый код ошибки, который в случае успешного выполнения равен 0.}}
	{{function_end}}		{{function_end}}

			Идентификаторы интерфейсов:

			{{BinaryDataStorageType}}

Ninok2801: Новая страница: «{{function_begin | return_code_t RepresentAs(BinaryDataStorageType type_id, void** ppInterface) noexcept; |{{IBinaryDataBase::RepresentAs brief}}}} {{function_par…»

2017-03-02T12:03:15Z

Новая страница: «{{function_begin | return_code_t RepresentAs(BinaryDataStorageType type_id, void** ppInterface) noexcept; |{{IBinaryDataBase::RepresentAs brief}}}} {{function_par…»

Новая страница

{{function_begin | return_code_t RepresentAs(BinaryDataStorageType type_id, void** ppInterface) noexcept; |{{IBinaryDataBase::RepresentAs brief}}}}
{{function_paramlist begin}}
{{function_paramlist add|type_id|}}
{{function_paramlist add|ppInterface|.|paramdir=[out]}}
{{function_paramlist end}}
{{function_return_value|32-битовый беззнаковый целый код ошибки, который в случае успешного выполнения равен 0.}}
{{function_end}}