/* Copyright 2017 - 2022 R. Thomas * Copyright 2017 - 2022 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_PE_RESOURCE_NODE_H_ #define LIEF_PE_RESOURCE_NODE_H_ #include #include #include #include "LIEF/Object.hpp" #include "LIEF/visibility.h" #include "LIEF/iterators.hpp" #include "LIEF/PE/enums.hpp" namespace LIEF { namespace PE { class ResourceDirectory; class ResourceData; class Parser; class Builder; //! Class which represents a Node in the resource tree. class LIEF_API ResourceNode : public Object { friend class Parser; friend class Builder; public: using childs_t = std::vector>; using it_childs = ref_iterator; using it_const_childs = const_ref_iterator; //! Enum that identifies the type of a node in //! the resource tree enum class TYPE { UNKNOWN = 0, DATA, DIRECTORY, }; ResourceNode(const ResourceNode& other); ResourceNode& operator=(const ResourceNode& other); ResourceNode(ResourceNode&& other); ResourceNode& operator=(ResourceNode&& other); void swap(ResourceNode& other); virtual ~ResourceNode(); virtual ResourceNode* clone() const = 0; //! Integer that identifies the Type, Name, or Language ID of the entry //! depending on its depth in the tree uint32_t id() const; //! Name of the entry const std::u16string& name() const; //! Iterator on node's children it_childs childs(); it_const_childs childs() const; //! ``True`` if the entry uses a name as ID bool has_name() const; //! Current depth of the Node in the resource tree uint32_t depth() const; //! ``True`` if the current entry is a ResourceDirectory. //! //! It can be safely casted with: //! //! ```cpp //! const auto& dir_node = static_cast(node); //! ``` bool is_directory() const; //! ``True`` if the current entry is a ResourceData. //! //! It can be safely casted with: //! //! ```cpp //! const auto& data_node = static_cast(node); //! ``` bool is_data() const; void id(uint32_t id); void name(const std::string& name); void name(const std::u16string& name); //! Add a ResourceDirectory to the current node ResourceNode& add_child(const ResourceDirectory& child); //! Add a ResourceData to the current node ResourceNode& add_child(const ResourceData& child); //! Delete the node with the given ``id`` void delete_child(uint32_t id); //! Delete the given node from the node's children void delete_child(const ResourceNode& node); void accept(Visitor& visitor) const override; bool operator==(const ResourceNode& rhs) const; bool operator!=(const ResourceNode& rhs) const; LIEF_API friend std::ostream& operator<<(std::ostream& os, const ResourceNode& node); protected: ResourceNode(); childs_t::iterator insert_child(std::unique_ptr child); TYPE type_ = TYPE::UNKNOWN; uint32_t id_ = 0; std::u16string name_; childs_t childs_; uint32_t depth_ = 0; }; } } #endif /* RESOURCENODE_H_ */