Files
lief-project-LIEF/include/LIEF/DEX/Method.hpp
T
2026-01-11 22:04:09 +01:00

119 lines
2.9 KiB
C++

/* Copyright 2017 - 2026 R. Thomas
* Copyright 2017 - 2026 Quarkslab
*
* 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_DEX_METHOD_H
#define LIEF_DEX_METHOD_H
#include <climits>
#include <vector>
#include "LIEF/visibility.h"
#include "LIEF/Object.hpp"
#include "LIEF/DEX/enums.hpp"
#include "LIEF/DEX/CodeInfo.hpp"
#include "LIEF/DEX/deopt.hpp"
namespace LIEF {
namespace DEX {
class Parser;
class Class;
class Prototype;
/// Class which represents a DEX::Method
class LIEF_API Method : public Object {
friend class Parser;
public:
using access_flags_list_t = std::vector<ACCESS_FLAGS>;
public:
using bytecode_t = std::vector<uint8_t>;
Method();
Method(std::string name, Class* parent = nullptr);
Method(const Method&);
Method& operator=(const Method&);
/// Name of the Method
const std::string& name() const;
/// True if a class is associated with this method
bool has_class() const;
/// DEX::Class associated with this Method or a nullptr
/// if not resolved
const Class* cls() const;
Class* cls();
/// Offset to the Dalvik Bytecode
uint64_t code_offset() const;
/// Dalvik Bytecode as bytes
const bytecode_t& bytecode() const;
/// Index in the DEX Methods pool
size_t index() const;
/// True if this method is a virtual one.
/// i.e. not **static**, **private**, **finale** or constructor
bool is_virtual() const;
/// Method's prototype or a nullptr if it is not resolved
const Prototype* prototype() const;
Prototype* prototype();
void insert_dex2dex_info(uint32_t pc, uint32_t index);
void accept(Visitor& visitor) const override;
const dex2dex_method_info_t& dex2dex_info() const;
/// Check if the current method has the given ACCESS_FLAGS
bool has(ACCESS_FLAGS f) const;
/// ACCESS_FLAGS as an std::set
access_flags_list_t access_flags() const;
// CodeInfo to get additional data about a method i.e. argument count
const CodeInfo& code_info() const;
LIEF_API friend std::ostream& operator<<(std::ostream& os, const Method& mtd);
~Method() override;
private:
void set_virtual(bool v);
private:
std::string name_;
Class* parent_ = nullptr;
Prototype* prototype_ = nullptr;
uint32_t access_flags_ = ACCESS_FLAGS::ACC_UNKNOWN;
uint32_t original_index_ = UINT_MAX;
bool is_virtual_ = false;
uint64_t code_offset_ = 0;
std::vector<uint8_t> bytecode_;
CodeInfo code_info_;
dex2dex_method_info_t dex2dex_info_;
};
} // Namespace DEX
} // Namespace LIEF
#endif