| /* |
| * Copyright (C) 2017 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 MINIKIN_HYPHENATOR_MAP_H |
| #define MINIKIN_HYPHENATOR_MAP_H |
| |
| #include <map> |
| #include <mutex> |
| |
| #include "minikin/Hyphenator.h" |
| #include "minikin/Macros.h" |
| |
| #include "Locale.h" |
| |
| namespace minikin { |
| |
| class HyphenatorMap { |
| public: |
| // This map doesn't take ownership of the hyphenator but we don't need to care about the |
| // ownership. In Android, the Hyphenator is allocated in Zygote and never gets released. |
| static void add(const std::string& localeStr, const Hyphenator* hyphenator) { |
| getInstance().addInternal(localeStr, hyphenator); |
| } |
| |
| static void addAlias(const std::string& fromLocaleStr, const std::string& toLocaleStr) { |
| getInstance().addAliasInternal(fromLocaleStr, toLocaleStr); |
| } |
| |
| // Remove all hyphenators from the map. This is test only method. |
| static void clear() { getInstance().clearInternal(); } |
| |
| // The returned pointer is never a dangling pointer. If nothing found for a given locale, |
| // returns a hyphenator which only processes soft hyphens. |
| // |
| // The Hyphenator lookup works with the following rules: |
| // 1. Search for the Hyphenator with the given locale. |
| // 2. If not found, try again with language + script + region + variant. |
| // 3. If not found, try again with language + region + variant. |
| // 4. If not found, try again with language + variant. |
| // 5. If not found, try again with language. |
| // 6. If not found, try again with script. |
| static const Hyphenator* lookup(const Locale& locale) { |
| return getInstance().lookupInternal(locale); |
| } |
| |
| protected: |
| // The following five methods are protected for testing purposes. |
| HyphenatorMap(); // Use getInstance() instead. |
| void addInternal(const std::string& localeStr, const Hyphenator* hyphenator); |
| void addAliasInternal(const std::string& fromLocaleStr, const std::string& toLocaleStr); |
| const Hyphenator* lookupInternal(const Locale& locale); |
| |
| private: |
| static HyphenatorMap& getInstance() { // Singleton. |
| static HyphenatorMap map; |
| return map; |
| } |
| |
| void clearInternal(); |
| |
| const Hyphenator* lookupByIdentifier(uint64_t id) const EXCLUSIVE_LOCKS_REQUIRED(mMutex); |
| const Hyphenator* lookupBySubtag(const Locale& locale, SubtagBits bits) const |
| EXCLUSIVE_LOCKS_REQUIRED(mMutex); |
| |
| const Hyphenator* mSoftHyphenOnlyHyphenator; |
| std::map<uint64_t, const Hyphenator*> mMap GUARDED_BY(mMutex); |
| |
| std::mutex mMutex; |
| }; |
| |
| } // namespace minikin |
| |
| #endif // MINIKIN_HYPHENATOR_MAP_H |