/* * 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_STRING_POOL_H #define AAPT_STRING_POOL_H #include "BigBuffer.h" #include "ConfigDescription.h" #include "StringPiece.h" #include #include #include #include #include namespace aapt { struct Span { std::u16string name; uint32_t firstChar; uint32_t lastChar; }; struct StyleString { std::u16string str; std::vector spans; }; class StringPool { public: struct Context { uint32_t priority; ConfigDescription config; }; class Entry; class Ref { public: Ref(); Ref(const Ref&); ~Ref(); Ref& operator=(const Ref& rhs); const std::u16string* operator->() const; const std::u16string& operator*() const; size_t getIndex() const; const Context& getContext() const; private: friend class StringPool; Ref(Entry* entry); Entry* mEntry; }; class StyleEntry; class StyleRef { public: StyleRef(); StyleRef(const StyleRef&); ~StyleRef(); StyleRef& operator=(const StyleRef& rhs); const StyleEntry* operator->() const; const StyleEntry& operator*() const; size_t getIndex() const; const Context& getContext() const; private: friend class StringPool; StyleRef(StyleEntry* entry); StyleEntry* mEntry; }; class Entry { public: std::u16string value; Context context; size_t index; private: friend class StringPool; friend class Ref; int ref; }; struct Span { Ref name; uint32_t firstChar; uint32_t lastChar; }; class StyleEntry { public: Ref str; std::vector spans; private: friend class StringPool; friend class StyleRef; int ref; }; using const_iterator = std::vector>::const_iterator; static bool flattenUtf8(BigBuffer* out, const StringPool& pool); static bool flattenUtf16(BigBuffer* out, const StringPool& pool); StringPool() = default; StringPool(const StringPool&) = delete; /** * Adds a string to the pool, unless it already exists. Returns * a reference to the string in the pool. */ Ref makeRef(const StringPiece16& str); /** * Adds a string to the pool, unless it already exists, with a context * object that can be used when sorting the string pool. Returns * a reference to the string in the pool. */ Ref makeRef(const StringPiece16& str, const Context& context); /** * Adds a style to the string pool and returns a reference to it. */ StyleRef makeRef(const StyleString& str); /** * Adds a style to the string pool with a context object that * can be used when sorting the string pool. Returns a reference * to the style in the string pool. */ StyleRef makeRef(const StyleString& str, const Context& context); /** * Adds a style from another string pool. Returns a reference to the * style in the string pool. */ StyleRef makeRef(const StyleRef& ref); /** * Moves pool into this one without coalescing strings. When this * function returns, pool will be empty. */ void merge(StringPool&& pool); /** * Retuns the number of strings in the table. */ inline size_t size() const; /** * Reserves space for strings and styles as an optimization. */ void hintWillAdd(size_t stringCount, size_t styleCount); /** * Sorts the strings according to some comparison function. */ void sort(const std::function& cmp); /** * Removes any strings that have no references. */ void prune(); private: friend const_iterator begin(const StringPool& pool); friend const_iterator end(const StringPool& pool); static bool flatten(BigBuffer* out, const StringPool& pool, bool utf8); Ref makeRefImpl(const StringPiece16& str, const Context& context, bool unique); std::vector> mStrings; std::vector> mStyles; std::multimap mIndexedStrings; }; // // Inline implementation // inline size_t StringPool::size() const { return mStrings.size(); } inline StringPool::const_iterator begin(const StringPool& pool) { return pool.mStrings.begin(); } inline StringPool::const_iterator end(const StringPool& pool) { return pool.mStrings.end(); } } // namespace aapt #endif // AAPT_STRING_POOL_H