develop/AWatchdog_8h_source.html

/*

 * AUI Framework - Declarative UI toolkit for modern C++20

 * Copyright (C) 2020-2025 Alex2772 and Contributors

 *

 * SPDX-License-Identifier: MPL-2.0

 *

 * This Source Code Form is subject to the terms of the Mozilla Public

 * License, v. 2.0. If a copy of the MPL was not distributed with this

 * file, You can obtain one at http://mozilla.org/MPL/2.0/.

 */


#pragma once


#include <AUI/Common/AObject.h>

#include <cassert>

#include <chrono>

#include "AUI/Common/AOptional.h"

#include "AUI/Thread/AMutex.h"

#include "AUI/Traits/concepts.h"

#include "AUI/Util/ARaiiHelper.h"

#include "AUI/Util/kAUI.h"


class API_AUI_CORE AWatchdog {

public:

    AWatchdog(std::chrono::high_resolution_clock::duration hangDuration = std::chrono::seconds(10)): mHangDuration(hangDuration) {}


    template<aui::invocable Operation>


    auto runOperation(Operation&& operation) -> decltype(operation()) {

        std::unique_lock lock(mSync);

        mBeginPoint = std::chrono::high_resolution_clock::now();

        AUI_DEFER {

            lock.lock();

            mBeginPoint.reset();

        };

        lock.unlock();

        return operation();

    }


    [[nodiscard]]

    bool isHang() const noexcept;


private:

    mutable AMutex mSync;

    std::chrono::high_resolution_clock::duration mHangDuration;

    AOptional<std::chrono::high_resolution_clock::time_point> mBeginPoint;

};


AOptional
Utility wrapper implementing the stack-allocated (fast) optional idiom.
Definition AOptional.h:33

AWatchdog::runOperation
auto runOperation(Operation &&operation) -> decltype(operation())
Runs callback which is subject to check for hangs.
Definition AWatchdog.h:52

AWatchdog::AWatchdog
AWatchdog(std::chrono::high_resolution_clock::duration hangDuration=std::chrono::seconds(10))
Definition AWatchdog.h:43

AWatchdog::isHang
bool isHang() const noexcept
Checks for hang state.

AUI_DEFER
#define AUI_DEFER
Defers execution of the next block to the end of current block (RAII scope).
Definition kAUI.h:196

AMutex
Basic syscall-based synchronization primitive.
Definition AMutex.h:33