/**
* Ashita SDK - Copyright (c) 2023 Ashita Development Team
* Contact: https://www.ashitaxi.com/
* Contact: https://discord.gg/Ashita
*
* This file is part of Ashita.
*
* Ashita is free software: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* Ashita is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with Ashita. If not, see .
*/
#ifndef ASHITA_SDK_SCOPEGUARD_H_INCLUDED
#define ASHITA_SDK_SCOPEGUARD_H_INCLUDED
#if defined(_MSC_VER) && (_MSC_VER >= 1020)
#pragma once
#endif
#include
#include
#include
namespace Ashita
{
/**
* Implements a slim and simple scope guard that can have multiple executed callbacks.
*
* This can be seen and used as a 'finally' type handler, allowing callbacks to be executed
* when scope is lost, ensuring certain tasks are executed/cleaned up.
*/
class ScopeGuard final
{
std::deque> m_Callbacks;
public:
ScopeGuard(void);
~ScopeGuard(void);
template
explicit ScopeGuard(Func&& f);
ScopeGuard(const ScopeGuard&) = delete;
ScopeGuard& operator=(const ScopeGuard&) = delete;
ScopeGuard& operator=(ScopeGuard&&) = delete;
template
ScopeGuard& operator+=(Func&& f);
void Disable(void) noexcept;
};
} // namespace Ashita
/**
* Constructor
*/
inline Ashita::ScopeGuard::ScopeGuard(void)
{}
/**
* Deconstructor
*/
inline Ashita::ScopeGuard::~ScopeGuard(void)
{
for (auto& f : this->m_Callbacks)
{
try
{
f();
}
catch (...)
{}
}
}
/**
* Overloaded Constructor
*
* @param {Func&&} f - The callback function to add to the callback queue.
*/
template
Ashita::ScopeGuard::ScopeGuard(Func&& f)
{
// Add the handler to the queue of callbacks..
this->operator+=(std::forward(f));
}
/**
* Addition Assignment Operator Overload
*
* @param {Func&&} f - The callback function to add to the callback queue.
* @return {ScopeGuard&} The lhs ScopeGuard object.
*/
template
Ashita::ScopeGuard& Ashita::ScopeGuard::operator+=(Func&& f)
{
this->m_Callbacks.emplace_front(std::forward(f));
return *this;
}
/**
* Clears the callback queue, preventing any callback from executing.
*/
inline void Ashita::ScopeGuard::Disable(void) noexcept
{
this->m_Callbacks.clear();
}
#endif // ASHITA_SDK_SCOPEGUARD_H_INCLUDED