tools/aapt2/Resource.h - platform/frameworks/base - Gitiles

 /*
  * 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 "ConfigDescription.h"
 #include "Source.h"

 #include "util/StringPiece.h"

 #include <iomanip>
 #include <limits>
 #include <string>
 #include <tuple>
 #include <vector>

 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,
     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;

     ResourceName() : type(ResourceType::kRaw) {}
     ResourceName(const StringPiece16& p, ResourceType t, const StringPiece16& e);

     bool isValid() const;
     std::u16string toString() 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;
 };

 /**
  * 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(uint8_t p, uint8_t t, uint16_t e);

     bool isValid() const;
     uint8_t packageId() const;
     uint8_t typeId() const;
     uint16_t entryId() const;
 };

 struct SourcedResourceName {
     ResourceName name;
     size_t line;
 };

 struct ResourceFile {
     // Name
     ResourceName name;

     // Configuration
     ConfigDescription config;

     // Source
     Source source;

     // Exported symbols
     std::vector<SourcedResourceName> exportedSymbols;
 };

 /**
  * Useful struct used as a key to represent a unique resource in associative containers.
  */
 struct ResourceKey {
     ResourceName name;
     ConfigDescription config;
 };

 bool operator<(const ResourceKey& a, const ResourceKey& b);

 /**
  * Useful struct used as a key to represent a unique resource in associative containers.
  * Holds a reference to the name, so that name better live longer than this key!
  */
 struct ResourceKeyRef {
     ResourceNameRef name;
     ConfigDescription config;

     ResourceKeyRef() = default;
     ResourceKeyRef(const ResourceNameRef& n, const ConfigDescription& c) : name(n), config(c) {
     }

     /**
      * Prevent taking a reference to a temporary. This is bad.
      */
     ResourceKeyRef(ResourceName&& n, const ConfigDescription& c) = delete;
 };

 bool operator<(const ResourceKeyRef& a, const ResourceKeyRef& b);

 //
 // 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(uint8_t p, uint8_t t, uint16_t e) : id((p << 24) | (t << 16) | 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 operator<(const ResourceId& lhs, const ResourceId& rhs) {
     return lhs.id < rhs.id;
 }

 inline bool operator>(const ResourceId& lhs, const ResourceId& rhs) {
     return lhs.id > rhs.id;
 }

 inline bool operator==(const ResourceId& lhs, const ResourceId& rhs) {
     return lhs.id == rhs.id;
 }

 inline bool operator!=(const ResourceId& lhs, const ResourceId& rhs) {
     return lhs.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 ResourceName::ResourceName(const StringPiece16& p, ResourceType t, const StringPiece16& e) :
         package(p.toString()), type(t), entry(e.toString()) {
 }

 inline bool ResourceName::isValid() const {
     return !package.empty() && !entry.empty();
 }

 inline bool operator<(const ResourceName& lhs, const ResourceName& rhs) {
     return std::tie(lhs.package, lhs.type, lhs.entry)
             < std::tie(rhs.package, rhs.type, rhs.entry);
 }

 inline bool operator==(const ResourceName& lhs, const ResourceName& rhs) {
     return std::tie(lhs.package, lhs.type, lhs.entry)
             == std::tie(rhs.package, rhs.type, rhs.entry);
 }

 inline bool operator!=(const ResourceName& lhs, const ResourceName& rhs) {
     return std::tie(lhs.package, lhs.type, lhs.entry)
             != std::tie(rhs.package, rhs.type, rhs.entry);
 }

 inline std::u16string ResourceName::toString() const {
     std::u16string result;
     if (!package.empty()) {
         result = package + u":";
     }
     return result + aapt::toString(type).toString() + u"/" + 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 operator<(const ResourceNameRef& lhs, const ResourceNameRef& rhs) {
     return std::tie(lhs.package, lhs.type, lhs.entry)
             < std::tie(rhs.package, rhs.type, rhs.entry);
 }

 inline bool operator==(const ResourceNameRef& lhs, const ResourceNameRef& rhs) {
     return std::tie(lhs.package, lhs.type, lhs.entry)
             == std::tie(rhs.package, rhs.type, rhs.entry);
 }

 inline bool operator!=(const ResourceNameRef& lhs, const ResourceNameRef& rhs) {
     return std::tie(lhs.package, lhs.type, lhs.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;
 }

 inline bool operator<(const ResourceName& lhs, const ResourceNameRef& b) {
     return ResourceNameRef(lhs) < b;
 }

 inline bool operator!=(const ResourceName& lhs, const ResourceNameRef& rhs) {
     return ResourceNameRef(lhs) != rhs;
 }

 inline bool operator==(const SourcedResourceName& lhs, const SourcedResourceName& rhs) {
     return lhs.name == rhs.name && lhs.line == rhs.line;
 }

 } // namespace aapt

 #endif // AAPT_RESOURCE_H
	/*
	* 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 "ConfigDescription.h"
	#include "Source.h"

	#include "util/StringPiece.h"

	#include <iomanip>
	#include <limits>
	#include <string>
	#include <tuple>
	#include <vector>

	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,
	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;

	ResourceName() : type(ResourceType::kRaw) {}
	ResourceName(const StringPiece16& p, ResourceType t, const StringPiece16& e);

	bool isValid() const;
	std::u16string toString() 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;
	};

	/**
	* 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(uint8_t p, uint8_t t, uint16_t e);

	bool isValid() const;
	uint8_t packageId() const;
	uint8_t typeId() const;
	uint16_t entryId() const;
	};

	struct SourcedResourceName {
	ResourceName name;
	size_t line;
	};

	struct ResourceFile {
	// Name
	ResourceName name;

	// Configuration
	ConfigDescription config;

	// Source
	Source source;

	// Exported symbols
	std::vector<SourcedResourceName> exportedSymbols;
	};

	/**
	* Useful struct used as a key to represent a unique resource in associative containers.
	*/
	struct ResourceKey {
	ResourceName name;
	ConfigDescription config;
	};

	bool operator<(const ResourceKey& a, const ResourceKey& b);

	/**
	* Useful struct used as a key to represent a unique resource in associative containers.
	* Holds a reference to the name, so that name better live longer than this key!
	*/
	struct ResourceKeyRef {
	ResourceNameRef name;
	ConfigDescription config;

	ResourceKeyRef() = default;
	ResourceKeyRef(const ResourceNameRef& n, const ConfigDescription& c) : name(n), config(c) {
	}

	/**
	* Prevent taking a reference to a temporary. This is bad.
	*/
	ResourceKeyRef(ResourceName&& n, const ConfigDescription& c) = delete;
	};

	bool operator<(const ResourceKeyRef& a, const ResourceKeyRef& b);

	//
	// 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(uint8_t p, uint8_t t, uint16_t e) : id((p << 24) \| (t << 16) \| 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 operator<(const ResourceId& lhs, const ResourceId& rhs) {
	return lhs.id < rhs.id;
	}

	inline bool operator>(const ResourceId& lhs, const ResourceId& rhs) {
	return lhs.id > rhs.id;
	}

	inline bool operator==(const ResourceId& lhs, const ResourceId& rhs) {
	return lhs.id == rhs.id;
	}

	inline bool operator!=(const ResourceId& lhs, const ResourceId& rhs) {
	return lhs.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 ResourceName::ResourceName(const StringPiece16& p, ResourceType t, const StringPiece16& e) :
	package(p.toString()), type(t), entry(e.toString()) {
	}

	inline bool ResourceName::isValid() const {
	return !package.empty() && !entry.empty();
	}

	inline bool operator<(const ResourceName& lhs, const ResourceName& rhs) {
	return std::tie(lhs.package, lhs.type, lhs.entry)
	< std::tie(rhs.package, rhs.type, rhs.entry);
	}

	inline bool operator==(const ResourceName& lhs, const ResourceName& rhs) {
	return std::tie(lhs.package, lhs.type, lhs.entry)
	== std::tie(rhs.package, rhs.type, rhs.entry);
	}

	inline bool operator!=(const ResourceName& lhs, const ResourceName& rhs) {
	return std::tie(lhs.package, lhs.type, lhs.entry)
	!= std::tie(rhs.package, rhs.type, rhs.entry);
	}

	inline std::u16string ResourceName::toString() const {
	std::u16string result;
	if (!package.empty()) {
	result = package + u":";
	}
	return result + aapt::toString(type).toString() + u"/" + 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 operator<(const ResourceNameRef& lhs, const ResourceNameRef& rhs) {
	return std::tie(lhs.package, lhs.type, lhs.entry)
	< std::tie(rhs.package, rhs.type, rhs.entry);
	}

	inline bool operator==(const ResourceNameRef& lhs, const ResourceNameRef& rhs) {
	return std::tie(lhs.package, lhs.type, lhs.entry)
	== std::tie(rhs.package, rhs.type, rhs.entry);
	}

	inline bool operator!=(const ResourceNameRef& lhs, const ResourceNameRef& rhs) {
	return std::tie(lhs.package, lhs.type, lhs.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;
	}

	inline bool operator<(const ResourceName& lhs, const ResourceNameRef& b) {
	return ResourceNameRef(lhs) < b;
	}

	inline bool operator!=(const ResourceName& lhs, const ResourceNameRef& rhs) {
	return ResourceNameRef(lhs) != rhs;
	}

	inline bool operator==(const SourcedResourceName& lhs, const SourcedResourceName& rhs) {
	return lhs.name == rhs.name && lhs.line == rhs.line;
	}

	} // namespace aapt

	#endif // AAPT_RESOURCE_H