/* * Copyright (c) 2021-2022, Tim Flynn * * SPDX-License-Identifier: BSD-2-Clause */ #pragma once #include #include #include #include #include #include #include #include #include namespace Locale { struct LanguageID { ErrorOr to_string() const; DeprecatedString to_deprecated_string() const; bool operator==(LanguageID const&) const = default; bool is_root { false }; Optional language {}; Optional script {}; Optional region {}; Vector variants {}; }; struct Keyword { DeprecatedString key {}; DeprecatedString value {}; }; struct LocaleExtension { Vector attributes {}; Vector keywords {}; }; struct TransformedField { DeprecatedString key {}; DeprecatedString value {}; }; struct TransformedExtension { Optional language {}; Vector fields {}; }; struct OtherExtension { char key {}; DeprecatedString value {}; }; using Extension = AK::Variant; struct LocaleID { DeprecatedString to_deprecated_string() const; template Vector remove_extension_type() { Vector removed_extensions {}; auto tmp_extensions = move(extensions); for (auto& extension : tmp_extensions) { if (extension.has()) removed_extensions.append(move(extension)); else extensions.append(move(extension)); } return removed_extensions; } LanguageID language_id {}; Vector extensions {}; Vector private_use_extensions {}; }; enum class Style : u8 { Long, Short, Narrow, }; struct DisplayPattern { StringView locale_pattern; StringView locale_separator; }; struct ListPatterns { StringView start; StringView middle; StringView end; StringView pair; }; // Note: These methods only verify that the provided strings match the EBNF grammar of the // Unicode identifier subtag (i.e. no validation is done that the tags actually exist). constexpr bool is_unicode_language_subtag(StringView subtag) { // unicode_language_subtag = alpha{2,3} | alpha{5,8} if ((subtag.length() < 2) || (subtag.length() == 4) || (subtag.length() > 8)) return false; return all_of(subtag, is_ascii_alpha); } constexpr bool is_unicode_script_subtag(StringView subtag) { // unicode_script_subtag = alpha{4} if (subtag.length() != 4) return false; return all_of(subtag, is_ascii_alpha); } constexpr bool is_unicode_region_subtag(StringView subtag) { // unicode_region_subtag = (alpha{2} | digit{3}) if (subtag.length() == 2) return all_of(subtag, is_ascii_alpha); if (subtag.length() == 3) return all_of(subtag, is_ascii_digit); return false; } constexpr bool is_unicode_variant_subtag(StringView subtag) { // unicode_variant_subtag = (alphanum{5,8} | digit alphanum{3}) if ((subtag.length() >= 5) && (subtag.length() <= 8)) return all_of(subtag, is_ascii_alphanumeric); if (subtag.length() == 4) return is_ascii_digit(subtag[0]) && all_of(subtag.substring_view(1), is_ascii_alphanumeric); return false; } bool is_type_identifier(StringView); Optional parse_unicode_language_id(StringView); Optional parse_unicode_locale_id(StringView); void canonicalize_unicode_extension_values(StringView key, DeprecatedString& value, bool remove_true); Optional canonicalize_unicode_locale_id(LocaleID&); DeprecatedString const& default_locale(); bool is_locale_available(StringView locale); Span get_available_keyword_values(StringView key); Span get_available_calendars(); Span get_available_collation_case_orderings(); Span get_available_collation_numeric_orderings(); Span get_available_collation_types(); Span get_available_currencies(); Span get_available_hour_cycles(); Span get_available_number_systems(); Style style_from_string(StringView style); StringView style_to_string(Style style); Optional locale_from_string(StringView locale); Optional language_from_string(StringView language); Optional territory_from_string(StringView territory); Optional script_tag_from_string(StringView script_tag); Optional currency_from_string(StringView currency); Optional date_field_from_string(StringView calendar); Optional list_pattern_type_from_string(StringView list_pattern_type); Optional key_from_string(StringView key); Optional keyword_ca_from_string(StringView ca); Optional keyword_co_from_string(StringView co); Optional keyword_hc_from_string(StringView hc); Optional keyword_kf_from_string(StringView kf); Optional keyword_kn_from_string(StringView kn); Optional keyword_nu_from_string(StringView nu); Vector get_keywords_for_locale(StringView locale, StringView key); Optional get_preferred_keyword_value_for_locale(StringView locale, StringView key); Optional get_locale_display_patterns(StringView locale); Optional format_locale_for_display(StringView locale, LocaleID locale_id); Optional get_locale_language_mapping(StringView locale, StringView language); Optional get_locale_territory_mapping(StringView locale, StringView territory); Optional get_locale_script_mapping(StringView locale, StringView script); Optional get_locale_long_currency_mapping(StringView locale, StringView currency); Optional get_locale_short_currency_mapping(StringView locale, StringView currency); Optional get_locale_narrow_currency_mapping(StringView locale, StringView currency); Optional get_locale_numeric_currency_mapping(StringView locale, StringView currency); Optional get_locale_calendar_mapping(StringView locale, StringView calendar); Optional get_locale_long_date_field_mapping(StringView locale, StringView date_field); Optional get_locale_short_date_field_mapping(StringView locale, StringView date_field); Optional get_locale_narrow_date_field_mapping(StringView locale, StringView date_field); Optional get_locale_list_patterns(StringView locale, StringView type, Style style); Optional character_order_from_string(StringView character_order); StringView character_order_to_string(CharacterOrder character_order); Optional character_order_for_locale(StringView locale); Optional resolve_language_alias(StringView language); Optional resolve_territory_alias(StringView territory); Optional resolve_script_tag_alias(StringView script_tag); Optional resolve_variant_alias(StringView variant); Optional resolve_subdivision_alias(StringView subdivision); void resolve_complex_language_aliases(LanguageID& language_id); Optional add_likely_subtags(LanguageID const& language_id); Optional remove_likely_subtags(LanguageID const& language_id); Optional resolve_most_likely_territory(LanguageID const& language_id); DeprecatedString resolve_most_likely_territory_alias(LanguageID const& language_id, StringView territory_alias); }