InterfaceExceptionGuardedCall

Материал из CAMaaS preliminary wiki
Перейти к навигации Перейти к поиску
template <class _Callable, class ... _Args>
auto InterfaceExceptionGuardedCall(_Callable&& callable, _Args&& ... args) noexcept -> return_code_t; //2

Осуществляет вызов указанного параметром Callable-объекта с заданным списком аргументов с защитой от исключений std::exception и Chusov::Exceptions::ChsvCodeException, возвращая соответствующий им код типа return_code_t.

Параметры шаблона
_CallableТип Callable-объекта, который вызывается функцией. Прототип объекта должен позволять однозначно выполнить вызов объекта с аргументами std::forward<_Args>(args).... Функциональный объект должен либо не возвращать значения (т.е. возвращаемый тип должен быть void), либо возвращать код return_code_t. В последнем случае, в отсутствие исключений, этот код возвращается функцией InterfaceExceptionGuardedCall.
_Args...Тип входных аргументов, над которыми вызывается Callable-объект fn.
Параметры
fnФункциональный объект типа _Callable, который вызывается над аргументами args....
...argsНабор входных аргументов, над которыми вызывается Callable-объект fn. Если объект fn является нестатическим методом класса, то первым аргуметом должен являтся экземпляр этого класса, над которым вызывается метод.
Возвращаемое значение:
Если вызов Callable-объекта fn привел к возникновению исключения std::exception или Chusov::Exceptions::ChsvCodeException, возвращается код return_code_t, соответствующий этому исключению. Иначе, если fn возвращает код return_code_t, то возвращается этот код. Если же функтор определяет в качестве типа возвращаемого значения void, возвращается CHSVERROR_SUCCESS (0x20000000).
См. также
InvokeInterfaceGetterВызывает указанный Callable объект, возвращающий return_code_t, и, если объект возвращает код успешного завершения, возвращает указанный индексом выходной параметр через return - иначе генерирует исключение типа Chusov::Exceptions::ChsvCodeException.
InvokeDomainInterfaceGetterВызывает указанный Callable объект, возвращающий domain_response_code_t, и, если объект возвращает код успешного завершения, возвращает указанный индексом выходной параметр через return - иначе генерирует исключение типа drc_exception.
Пример
_Success_(_ChsvSucceeded(return)) return_code_t PLATFORM_NATIVE_CALLING_CONVENTION ShiftCurPos(std::int64_t cbShift) noexcept
{
    auto nResult = InterfaceExceptionGuardedCall([=]() -> return_code_t
    {
        auto cbNewOff = this->position() + cbShift;
        if ((cbShift < 0 && file_t::file_offset_type(-cbShift) > this->position()) ||  cbNewOff > this->file().size() || cbNewOff < this->position())
            throw Chusov::Exceptions::InvalidParameterException();
        this->position() = cbNewOff;
        return CHSVERROR_SUCCESS;
    });
    return nResult;
}
_Success_(_ChsvSucceeded(return)) return_code_t PLATFORM_NATIVE_CALLING_CONVENTION GetNode(std::uint32_t nFlags, _In_opt_ void* pParams, _Deref_out_ ITCPNode** ppNode)
{
	auto nError = InterfaceExceptionGuardedCall([&]() -> void
	{
		*ppNode = unique_interface_ptr<ITCPNode>(new CRemoteNodeTCPServer()).release();
	});
	if (_ChsvFailed(nError))
		*ppNode = nullptr;
	return nError;
}