LIEF: Library to Instrument Executable Formats Version 0.15.1
Loading...
Searching...
No Matches
ResourceNode.hpp
Go to the documentation of this file.
1/* Copyright 2017 - 2024 R. Thomas
2 * Copyright 2017 - 2024 Quarkslab
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 * http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16#ifndef LIEF_PE_RESOURCE_NODE_H
17#define LIEF_PE_RESOURCE_NODE_H
18#include <string>
19#include <vector>
20#include <memory>
21
22#include "LIEF/Object.hpp"
23#include "LIEF/visibility.h"
24#include "LIEF/iterators.hpp"
25
26namespace LIEF {
27namespace PE {
28
29class ResourceDirectory;
30class ResourceData;
31
32class Parser;
33class Builder;
34
37
38 friend class Parser;
39 friend class Builder;
40
41 public:
42 using childs_t = std::vector<std::unique_ptr<ResourceNode>>;
45
47 enum class TYPE {
48 UNKNOWN = 0,
49 DATA,
50 DIRECTORY,
51 };
52
55
58
59 void swap(ResourceNode& other);
60
61 ~ResourceNode() override;
62
63 virtual std::unique_ptr<ResourceNode> clone() const = 0;
64
67 uint32_t id() const {
68 return id_;
69 }
70
72 const std::u16string& name() const {
73 return name_;
74 }
75
78 return childs_;
79 }
81 return childs_;
82 }
83
85 bool has_name() const {
86 return static_cast<bool>(id() & 0x80000000);
87 }
88
90 uint32_t depth() const {
91 return depth_;
92 }
93
101 bool is_directory() const {
102 return type_ == TYPE::DIRECTORY;
103 }
104
112 bool is_data() const {
113 return type_ == TYPE::DATA;
114 }
115
116 void id(uint32_t id) {
117 id_ = id;
118 }
119 void name(const std::string& name);
120
121 void name(std::u16string name) {
122 name_ = std::move(name);
123 }
124
127
130
132 void delete_child(uint32_t id);
133
135 void delete_child(const ResourceNode& node);
136
137 void accept(Visitor& visitor) const override;
138
139 LIEF_API friend std::ostream& operator<<(std::ostream& os, const ResourceNode& node);
140
141 protected:
142 ResourceNode();
143 ResourceNode(TYPE type);
144 childs_t::iterator insert_child(std::unique_ptr<ResourceNode> child);
145 TYPE type_ = TYPE::UNKNOWN;
146 uint32_t id_ = 0;
147 std::u16string name_;
148 childs_t childs_;
149 uint32_t depth_ = 0;
150};
151}
152}
153#endif /* RESOURCENODE_H */
Definition Object.hpp:25
Class that is used to rebuild a raw PE binary from a PE::Binary object.
Definition PE/Builder.hpp:45
Main interface to parse PE binaries. In particular the static functions: Parser::parse should be used...
Definition PE/Parser.hpp:47
Class which represents a Data Node in the PE resources tree.
Definition ResourceData.hpp:32
Definition ResourceDirectory.hpp:33
Class which represents a Node in the resource tree.
Definition ResourceNode.hpp:36
bool is_directory() const
True if the current entry is a ResourceDirectory.
Definition ResourceNode.hpp:101
void delete_child(uint32_t id)
Delete the node with the given id
ResourceNode & add_child(const ResourceDirectory &child)
Add a ResourceDirectory to the current node.
std::vector< std::unique_ptr< ResourceNode > > childs_t
Definition ResourceNode.hpp:42
it_const_childs childs() const
Definition ResourceNode.hpp:80
ResourceNode & operator=(const ResourceNode &other)
const std::u16string & name() const
Name of the entry.
Definition ResourceNode.hpp:72
bool is_data() const
True if the current entry is a ResourceData.
Definition ResourceNode.hpp:112
uint32_t depth() const
Current depth of the Node in the resource tree.
Definition ResourceNode.hpp:90
ResourceNode(ResourceNode &&other)
bool has_name() const
True if the entry uses a name as ID
Definition ResourceNode.hpp:85
void delete_child(const ResourceNode &node)
Delete the given node from the node's children.
ResourceNode(const ResourceNode &other)
virtual std::unique_ptr< ResourceNode > clone() const =0
uint32_t id() const
Integer that identifies the Type, Name, or Language ID of the entry depending on its depth in the tre...
Definition ResourceNode.hpp:67
it_childs childs()
Iterator on node's children.
Definition ResourceNode.hpp:77
void swap(ResourceNode &other)
void name(std::u16string name)
Definition ResourceNode.hpp:121
TYPE
Enum that identifies the type of a node in the resource tree.
Definition ResourceNode.hpp:47
void accept(Visitor &visitor) const override
ResourceNode & add_child(const ResourceData &child)
Add a ResourceData to the current node.
void name(const std::string &name)
void id(uint32_t id)
Definition ResourceNode.hpp:116
friend std::ostream & operator<<(std::ostream &os, const ResourceNode &node)
ResourceNode & operator=(ResourceNode &&other)
Definition Visitor.hpp:224
Iterator which returns reference on container's values.
Definition iterators.hpp:48
LIEF namespace.
Definition Abstract/Binary.hpp:32
#define LIEF_API
Definition visibility.h:41