DWARF/editor/Function.hpp

Go to the documentation of this file.

/* Copyright 2022 - 2026 R. Thomas
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
#ifndef LIEF_DWARF_EDITOR_FUNCTION_H
#define LIEF_DWARF_EDITOR_FUNCTION_H
#include <cstdint>
#include <memory>
#include <string>
#include <vector>
 
#include "LIEF/compiler_attributes.hpp"
#include "LIEF/visibility.h"
 
 
namespace LIEF::dwarf::editor {
class Type;
class Variable;
 
namespace details {
class Function;
class FunctionParameter;
class FunctionLexicalBlock;
class FunctionLabel;
}

class LIEF_API Function {
  public:
  struct LIEF_API range_t {
    range_t() = default;
    range_t(uint64_t start, uint64_t end) :
      start(start),
      end(end) {}
    uint64_t start = 0;
    uint64_t end = 0;
  };

  class LIEF_API Parameter {
    public:
    Parameter() = delete;
    Parameter(std::unique_ptr<details::FunctionParameter> impl);
 
    ~Parameter();

    Parameter& assign_register(const std::string& name) LIEF_LIFETIMEBOUND;

    Parameter& assign_register(uint64_t reg) LIEF_LIFETIMEBOUND;
 
    private:
    std::unique_ptr<details::FunctionParameter> impl_;
  };

  class LIEF_API LexicalBlock {
    public:
    LexicalBlock() = delete;
    LexicalBlock(std::unique_ptr<details::FunctionLexicalBlock> impl);

    std::unique_ptr<LexicalBlock> add_block(uint64_t start,
                                            uint64_t end) LIEF_LIFETIMEBOUND;

    std::unique_ptr<LexicalBlock>
        add_block(const std::vector<range_t>& range) LIEF_LIFETIMEBOUND;

    LexicalBlock&
        add_description(const std::string& description) LIEF_LIFETIMEBOUND;

    LexicalBlock& add_name(const std::string& name) LIEF_LIFETIMEBOUND;
 
    ~LexicalBlock();
 
    private:
    std::unique_ptr<details::FunctionLexicalBlock> impl_;
  };

  class LIEF_API Label {
    public:
    Label() = delete;
    Label(std::unique_ptr<details::FunctionLabel> impl);
 
    ~Label();
 
    private:
    std::unique_ptr<details::FunctionLabel> impl_;
  };
 
  Function() = delete;
  Function(std::unique_ptr<details::Function> impl);

  Function& set_address(uint64_t addr) LIEF_LIFETIMEBOUND;

  Function& set_low_high(uint64_t low, uint64_t high) LIEF_LIFETIMEBOUND;

  Function& set_ranges(const std::vector<range_t>& ranges) LIEF_LIFETIMEBOUND;

  Function& set_external() LIEF_LIFETIMEBOUND;

  Function& set_return_type(const Type& type) LIEF_LIFETIMEBOUND;

  std::unique_ptr<Parameter> add_parameter(const std::string& name,
                                           const Type& type) LIEF_LIFETIMEBOUND;

  std::unique_ptr<Variable>
      create_stack_variable(const std::string& name) LIEF_LIFETIMEBOUND;

  std::unique_ptr<LexicalBlock> add_lexical_block(uint64_t start,
                                                  uint64_t end) LIEF_LIFETIMEBOUND;

  std::unique_ptr<Label> add_label(uint64_t addr,
                                   const std::string& label) LIEF_LIFETIMEBOUND;

  Function& add_description(const std::string& description) LIEF_LIFETIMEBOUND;
 
  ~Function();
 
  private:
  std::unique_ptr<details::Function> impl_;
};
 
}
 
 
#endif