tools/aapt2/StringPool.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_STRING_POOL_H
#define AAPT_STRING_POOL_H

#include "ConfigDescription.h"
#include "util/BigBuffer.h"
#include "util/StringPiece.h"

#include <functional>
#include <memory>
#include <string>
#include <unordered_map>
#include <vector>

namespace aapt {

struct Span {
  std::string name;
  uint32_t firstChar;
  uint32_t lastChar;
};

struct StyleString {
  std::string str;
  std::vector<Span> spans;
};

class StringPool {
 public:
  class Context {
   public:
    enum : uint32_t {
      kStylePriority = 0u,
      kHighPriority = 1u,
      kNormalPriority = 0x7fffffffu,
      kLowPriority = 0xffffffffu,
    };
    uint32_t priority = kNormalPriority;
    ConfigDescription config;

    Context() = default;
    Context(uint32_t p, const ConfigDescription& c) : priority(p), config(c) {}
    explicit Context(uint32_t p) : priority(p) {}
    explicit Context(const ConfigDescription& c)
        : priority(kNormalPriority), config(c) {}
  };

  class Entry;

  class Ref {
   public:
    Ref();
    Ref(const Ref&);
    ~Ref();

    Ref& operator=(const Ref& rhs);
    const std::string* operator->() const;
    const std::string& operator*() const;

    size_t getIndex() const;
    const Context& getContext() const;

   private:
    friend class StringPool;

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

    explicit StyleRef(StyleEntry* entry);

    StyleEntry* mEntry;
  };

  class Entry {
   public:
    std::string 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<Span> spans;

   private:
    friend class StringPool;
    friend class StyleRef;

    int ref;
  };

  using const_iterator = std::vector<std::unique_ptr<Entry>>::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 StringPiece& 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 StringPiece& 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<bool(const Entry&, const Entry&)>& 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 StringPiece& str, const Context& context, bool unique);

  std::vector<std::unique_ptr<Entry>> mStrings;
  std::vector<std::unique_ptr<StyleEntry>> mStyles;
  std::unordered_multimap<StringPiece, Entry*> 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