stacktrace.hpp

浏览该文件的文档.

#ifndef NEFORCE_CORE_SYSTEM_STACKTRACE_HPP__
#define NEFORCE_CORE_SYSTEM_STACKTRACE_HPP__

 
#include "NeForce/core/interface/istringify.hpp"
#include "NeForce/core/exception/exception_ptr.hpp"
NEFORCE_BEGIN_NAMESPACE__


class NEFORCE_API stacktrace : public istringify<stacktrace> {
public:
    class NEFORCE_API frame : public istringify<frame> {
    private:
        void* address_ = nullptr; 
 
    public:
        frame() noexcept = default;

        explicit frame(void* addr) noexcept :
        address_(addr) {}

        NEFORCE_NODISCARD void* address() const noexcept { return address_; }

        NEFORCE_NODISCARD string name() const;

        NEFORCE_NODISCARD string source_file() const;

        NEFORCE_NODISCARD size_t source_line() const;

        NEFORCE_NODISCARD bool operator==(const frame& other) const noexcept { return address_ == other.address_; }

        NEFORCE_NODISCARD bool operator!=(const frame& other) const noexcept { return !(*this == other); }

        NEFORCE_NODISCARD string to_string() const;
    };

    enum format_flags {
        FMT_DEFAULT = 0,     
        FMT_SHOW_SOURCE = 1, 
        FMT_NO_ADDRESS = 2,  
    };

    friend constexpr format_flags operator|(format_flags a, format_flags b) noexcept {
        return static_cast<format_flags>(static_cast<int>(a) | static_cast<int>(b));
    }

    friend constexpr format_flags operator&(format_flags a, format_flags b) noexcept {
        return static_cast<format_flags>(static_cast<int>(a) & static_cast<int>(b));
    }
 
private:
    vector<frame> frames_; 
 
public:
    explicit stacktrace(size_t skip = 0, size_t max_depth = 64);

    NEFORCE_NODISCARD static stacktrace current(size_t skip = 0, size_t max_depth = 64);

    NEFORCE_NODISCARD static stacktrace from_exception(const exception_ptr& ep, size_t max_depth = 64);

    NEFORCE_NODISCARD size_t size() const noexcept { return frames_.size(); }

    NEFORCE_NODISCARD bool empty() const noexcept { return frames_.empty(); }

    NEFORCE_NODISCARD const frame& operator[](const size_t idx) const noexcept { return frames_[idx]; }

    NEFORCE_NODISCARD frame& operator[](const size_t idx) noexcept { return frames_[idx]; }

    NEFORCE_NODISCARD auto begin() const noexcept { return frames_.begin(); }

    NEFORCE_NODISCARD auto end() const noexcept { return frames_.end(); }

    NEFORCE_NODISCARD auto cbegin() const noexcept { return frames_.cbegin(); }

    NEFORCE_NODISCARD auto cend() const noexcept { return frames_.cend(); }

    NEFORCE_NODISCARD string to_string() const;

    NEFORCE_NODISCARD string to_string(format_flags flags) const;
};
 // Stacktrace
 
NEFORCE_END_NAMESPACE__
#endif // NEFORCE_CORE_SYSTEM_STACKTRACE_HPP__