V-Gears/V-Gears-Installer/include/decompiler/Function.h

/*
 * Copyright (C) 2022 The V-Gears Team
 *
 * This file is part of V-Gears
 *
 * V-Gears is free software: you can redistribute it and/or modify it under
 * terms of the GNU General Public License as published by the Free Software
 * Foundation, version 3.0 (GPLv3) of the License.
 *
 * V-Gears 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 General Public License for more details.
 */

#pragma once

#include <set>
#include "CodeGenerator.h"
#include "Disassembler.h"
#include "Graph.h"

/**
 * Structure representing a function.
 */
struct Function {

        /**
         * Constructor.
         *
         * Required for use with STL, should not be called manually.
         */
        Function(): start_addr(0), end_addr(0), num_instructions(0), ret_val(true){}

        /**
         * Constructor.
         *
         * @param start_addr[in] Address of the first instruction in the function.
         * @param end_addr[in] Address of the last instruction in the function
         */
        Function(uint32 start_addr, uint32 end_addr):
          start_addr(start_addr), end_addr(end_addr), num_instructions(0), ret_val(true){}

        /**
         * The function starting address.
         */
        uint32 start_addr;

        /**
         * The function ending address.
         */
        uint32 end_addr;

        /**
         * Number of instructions in the function.
         */
        uint32 num_instructions;

        /**
         * The name of the function.
         */
        std::string name;

        /**
         * The function vertex.
         */
        GraphVertex vertex;

        /**
         * Number of arguments in the function.
         */
        uint32 num_args;

        /**
         * Return value of the function.
         */
        bool ret_val;

        /**
         * Metadata for code generation.
         */
        std::string metadata;

};