77 lines
2.7 KiB
C++
77 lines
2.7 KiB
C++
// Copyright 2018 The Chromium Authors
|
|
// Use of this source code is governed by a BSD-style license that can be
|
|
// found in the LICENSE file.
|
|
//
|
|
// This file declares a helper class for selecting a supported language from a
|
|
// set of candidates.
|
|
|
|
#ifndef BASE_WIN_EMBEDDED_I18N_LANGUAGE_SELECTOR_H_
|
|
#define BASE_WIN_EMBEDDED_I18N_LANGUAGE_SELECTOR_H_
|
|
|
|
#include <string>
|
|
#include <utility>
|
|
#include <vector>
|
|
|
|
#include "base/base_export.h"
|
|
#include "base/containers/span.h"
|
|
#include "base/strings/string_piece.h"
|
|
|
|
namespace base {
|
|
namespace win {
|
|
namespace i18n {
|
|
|
|
// Selects a language from a set of available translations based on the user's
|
|
// preferred language list. An optional preferred language may be provided to
|
|
// override selection should a corresponding translation be available.
|
|
class BASE_EXPORT LanguageSelector {
|
|
public:
|
|
using LangToOffset = std::pair<WStringPiece, size_t>;
|
|
|
|
// Constructor to be used for users of this class that will provide the actual
|
|
// language offsets that will be used.
|
|
// |preferred_language| is an optional language used to as higher priority
|
|
// language when determining the matched language. This languages will
|
|
// take precedence over the system defined languages.
|
|
// |languages_to_offset_begin| and |languages_to_offset_end| point to a sorted
|
|
// array of language identifiers (and their offsets) for which translations
|
|
// are available.
|
|
LanguageSelector(WStringPiece preferred_language,
|
|
span<const LangToOffset> languages_to_offset);
|
|
|
|
// Constructor for testing purposes.
|
|
// |candidates| is a list of all candidate languages that can be used to
|
|
// determine which language to use.
|
|
// |languages_to_offset_begin| and |languages_to_offset_end| point to a sorted
|
|
// array of language identifiers (and their offsets) for which translations
|
|
// are available.
|
|
LanguageSelector(const std::vector<std::wstring>& candidates,
|
|
span<const LangToOffset> languages_to_offset);
|
|
|
|
LanguageSelector(const LanguageSelector&) = delete;
|
|
LanguageSelector& operator=(const LanguageSelector&) = delete;
|
|
|
|
~LanguageSelector();
|
|
|
|
// The offset of the matched language (i.e., IDS_L10N_OFFSET_*).
|
|
size_t offset() const { return selected_offset_; }
|
|
|
|
// The full name of the candidate language for which a match was found.
|
|
const std::wstring& matched_candidate() const { return matched_candidate_; }
|
|
|
|
// The name of the selected translation.
|
|
const std::wstring& selected_translation() const {
|
|
return selected_language_;
|
|
}
|
|
|
|
private:
|
|
std::wstring matched_candidate_;
|
|
std::wstring selected_language_;
|
|
size_t selected_offset_;
|
|
};
|
|
|
|
} // namespace i18n
|
|
} // namespace win
|
|
} // namespace base
|
|
|
|
#endif // BASE_WIN_EMBEDDED_I18N_LANGUAGE_SELECTOR_H_
|