/* * Copyright (C) 2015 The Android Open Source Project * * 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 AAPT_RESOURCE_H #define AAPT_RESOURCE_H #include "StringPiece.h" #include <iomanip> #include <limits> #include <string> #include <tuple> namespace aapt { /** * The various types of resource types available. Corresponds * to the 'type' in package:type/entry. */ enum class ResourceType { kAnim, kAnimator, kArray, kAttr, kAttrPrivate, kBool, kColor, kDimen, kDrawable, kFraction, kId, kInteger, kIntegerArray, kInterpolator, kLayout, kMenu, kMipmap, kPlurals, kRaw, kString, kStyle, kStyleable, kTransition, kXml, }; StringPiece16 toString(ResourceType type); /** * Returns a pointer to a valid ResourceType, or nullptr if * the string was invalid. */ const ResourceType* parseResourceType(const StringPiece16& str); /** * A resource's name. This can uniquely identify * a resource in the ResourceTable. */ struct ResourceName { std::u16string package; ResourceType type; std::u16string entry; bool isValid() const; bool operator<(const ResourceName& rhs) const; bool operator==(const ResourceName& rhs) const; bool operator!=(const ResourceName& rhs) const; }; /** * Same as ResourceName, but uses StringPieces instead. * Use this if you need to avoid copying and know that * the lifetime of this object is shorter than that * of the original string. */ struct ResourceNameRef { StringPiece16 package; ResourceType type; StringPiece16 entry; ResourceNameRef() = default; ResourceNameRef(const ResourceNameRef&) = default; ResourceNameRef(ResourceNameRef&&) = default; ResourceNameRef(const ResourceName& rhs); ResourceNameRef(const StringPiece16& p, ResourceType t, const StringPiece16& e); ResourceNameRef& operator=(const ResourceNameRef& rhs) = default; ResourceNameRef& operator=(ResourceNameRef&& rhs) = default; ResourceNameRef& operator=(const ResourceName& rhs); ResourceName toResourceName() const; bool isValid() const; bool operator<(const ResourceNameRef& rhs) const; bool operator==(const ResourceNameRef& rhs) const; bool operator!=(const ResourceNameRef& rhs) const; }; /** * A binary identifier representing a resource. Internally it * is a 32bit integer split as follows: * * 0xPPTTEEEE * * PP: 8 bit package identifier. 0x01 is reserved for system * and 0x7f is reserved for the running app. * TT: 8 bit type identifier. 0x00 is invalid. * EEEE: 16 bit entry identifier. */ struct ResourceId { uint32_t id; ResourceId(); ResourceId(const ResourceId& rhs); ResourceId(uint32_t resId); ResourceId(size_t p, size_t t, size_t e); bool isValid() const; uint8_t packageId() const; uint8_t typeId() const; uint16_t entryId() const; bool operator<(const ResourceId& rhs) const; bool operator==(const ResourceId& rhs) const; }; // // ResourceId implementation. // inline ResourceId::ResourceId() : id(0) { } inline ResourceId::ResourceId(const ResourceId& rhs) : id(rhs.id) { } inline ResourceId::ResourceId(uint32_t resId) : id(resId) { } inline ResourceId::ResourceId(size_t p, size_t t, size_t e) : id(0) { if (p > std::numeric_limits<uint8_t>::max() || t > std::numeric_limits<uint8_t>::max() || e > std::numeric_limits<uint16_t>::max()) { // This will leave the ResourceId in an invalid state. return; } id = (static_cast<uint8_t>(p) << 24) | (static_cast<uint8_t>(t) << 16) | static_cast<uint16_t>(e); } inline bool ResourceId::isValid() const { return (id & 0xff000000u) != 0 && (id & 0x00ff0000u) != 0; } inline uint8_t ResourceId::packageId() const { return static_cast<uint8_t>(id >> 24); } inline uint8_t ResourceId::typeId() const { return static_cast<uint8_t>(id >> 16); } inline uint16_t ResourceId::entryId() const { return static_cast<uint16_t>(id); } inline bool ResourceId::operator<(const ResourceId& rhs) const { return id < rhs.id; } inline bool ResourceId::operator==(const ResourceId& rhs) const { return id == rhs.id; } inline ::std::ostream& operator<<(::std::ostream& out, const ResourceId& resId) { std::ios_base::fmtflags oldFlags = out.flags(); char oldFill = out.fill(); out << "0x" << std::internal << std::setfill('0') << std::setw(8) << std::hex << resId.id; out.flags(oldFlags); out.fill(oldFill); return out; } // // ResourceType implementation. // inline ::std::ostream& operator<<(::std::ostream& out, const ResourceType& val) { return out << toString(val); } // // ResourceName implementation. // inline bool ResourceName::isValid() const { return !package.empty() && !entry.empty(); } inline bool ResourceName::operator<(const ResourceName& rhs) const { return std::tie(package, type, entry) < std::tie(rhs.package, rhs.type, rhs.entry); } inline bool ResourceName::operator==(const ResourceName& rhs) const { return std::tie(package, type, entry) == std::tie(rhs.package, rhs.type, rhs.entry); } inline bool ResourceName::operator!=(const ResourceName& rhs) const { return std::tie(package, type, entry) != std::tie(rhs.package, rhs.type, rhs.entry); } inline ::std::ostream& operator<<(::std::ostream& out, const ResourceName& name) { if (!name.package.empty()) { out << name.package << ":"; } return out << name.type << "/" << name.entry; } // // ResourceNameRef implementation. // inline ResourceNameRef::ResourceNameRef(const ResourceName& rhs) : package(rhs.package), type(rhs.type), entry(rhs.entry) { } inline ResourceNameRef::ResourceNameRef(const StringPiece16& p, ResourceType t, const StringPiece16& e) : package(p), type(t), entry(e) { } inline ResourceNameRef& ResourceNameRef::operator=(const ResourceName& rhs) { package = rhs.package; type = rhs.type; entry = rhs.entry; return *this; } inline ResourceName ResourceNameRef::toResourceName() const { return { package.toString(), type, entry.toString() }; } inline bool ResourceNameRef::isValid() const { return !package.empty() && !entry.empty(); } inline bool ResourceNameRef::operator<(const ResourceNameRef& rhs) const { return std::tie(package, type, entry) < std::tie(rhs.package, rhs.type, rhs.entry); } inline bool ResourceNameRef::operator==(const ResourceNameRef& rhs) const { return std::tie(package, type, entry) == std::tie(rhs.package, rhs.type, rhs.entry); } inline bool ResourceNameRef::operator!=(const ResourceNameRef& rhs) const { return std::tie(package, type, entry) != std::tie(rhs.package, rhs.type, rhs.entry); } inline ::std::ostream& operator<<(::std::ostream& out, const ResourceNameRef& name) { if (!name.package.empty()) { out << name.package << ":"; } return out << name.type << "/" << name.entry; } } // namespace aapt #endif // AAPT_RESOURCE_H