locale.hpp

浏览该文件的文档.

#ifndef NEFORCE_CORE_SYSTEM_LOCALE_HPP__
#define NEFORCE_CORE_SYSTEM_LOCALE_HPP__

 
#include "NeForce/core/container/vector.hpp"
#include "NeForce/core/exception/system_exception.hpp"
NEFORCE_BEGIN_NAMESPACE__
 
class date;
class time;
class datetime;
class timestamp;
 


struct locale_exception final : system_exception {
    explicit locale_exception(const char* info = "Locale Operation Failed",
                              const error_code code = last_error()) noexcept :
    system_exception(info, code) {}
 
    explicit locale_exception(const exception& e) :
    system_exception(e) {}
 
    ~locale_exception() override = default;
 
    NEFORCE_NODISCARD const char* type() const noexcept override { return "locale_exception"; }
};
 // Exceptions


class NEFORCE_API locale {
public:
    enum class collate_strength : int32_t {
        primary = 0,    
        secondary = 1,  
        tertiary = 2,   
        quaternary = 3, 
        identical = 15  
    };

    enum class date_style : int8_t {
        none = -1,     
        full = 0,      
        long_fmt = 1,  
        medium = 2,    
        short_fmt = 3, 
        relative = 4   
    };

    enum class time_style : int8_t {
        none = -1,     
        full = 0,      
        long_fmt = 1,  
        medium = 2,    
        short_fmt = 3, 
        relative = 4   
    };

    enum class measurement_system : uint8_t {
        SI, 
        US, 
        UK  
    };

    enum class text_direction : uint8_t {
        LTR, 
        RTL  
    };

    struct numeric_info {
        string decimal_point;   
        string thousands_sep;   
        string grouping;        
        string percent_sign;    
        string minus_sign;      
        string plus_sign;       
        string exponential;     
        string nan_symbol;      
        string infinity_symbol; 
    };

    struct monetary_info {
        string currency_symbol;      
        string int_curr_symbol;      
        string mon_decimal_point;    
        string mon_thousands_sep;    
        string mon_grouping;         
        string positive_sign;        
        string negative_sign;        
        int32_t frac_digits{2};      
        int32_t int_frac_digits{2};  
        int32_t cash_frac_digits{2}; 
        bool p_cs_precedes{true};    
        bool n_cs_precedes{true};    
        int32_t p_sep_by_space{0};   
        int32_t n_sep_by_space{0};   
    };

    struct time_info {
        string date_fmt;                 
        string time_fmt;                 
        string datetime_fmt;             
        vector<string> day_names;        
        vector<string> abbr_day_names;   
        vector<string> month_names;      
        vector<string> abbr_month_names; 
        string am_str;                   
        string pm_str;                   
    };
 
private:
    string name_;              
    string icu_name_;          
    void* collator_{nullptr};  
    void* converter_{nullptr}; 
 
    mutable void* num_fmt_{nullptr};  
    mutable void* curr_fmt_{nullptr}; 
    mutable void* date_fmt_{nullptr}; 
 
    string language_code_; 
    string script_code_;   
    string country_code_;  
    string variant_code_;  

    void load(const string& bcp47);

    void cleanup() noexcept;
 
public:
    locale();

    explicit locale(const string& name);

    ~locale();

    locale(const locale& other);

    locale& operator=(const locale& other);

    locale(locale&& other) noexcept;

    locale& operator=(locale&& other) noexcept;

    NEFORCE_NODISCARD static locale classic();

    NEFORCE_NODISCARD static locale system();

    NEFORCE_NODISCARD static locale from_name(const string& name);

    NEFORCE_NODISCARD const string& name() const noexcept { return name_; }

    NEFORCE_NODISCARD const string& language_code() const noexcept { return language_code_; }

    NEFORCE_NODISCARD const string& script_code() const noexcept { return script_code_; }

    NEFORCE_NODISCARD const string& country_code() const noexcept { return country_code_; }

    NEFORCE_NODISCARD const string& variant_code() const noexcept { return variant_code_; }

    NEFORCE_NODISCARD string display_name(const locale& display_locale) const;

    NEFORCE_NODISCARD string native_language_name() const;

    NEFORCE_NODISCARD string native_country_name() const;

    NEFORCE_NODISCARD text_direction direction() const;

    NEFORCE_NODISCARD measurement_system measurement() const;

    NEFORCE_NODISCARD int32_t first_day_of_week() const;

    NEFORCE_NODISCARD vector<string> ui_languages() const;
 
    NEFORCE_NODISCARD static bool is_alpha(char32_t cp) noexcept;       
    NEFORCE_NODISCARD static bool is_digit(char32_t cp) noexcept;       
    NEFORCE_NODISCARD static bool is_alnum(char32_t cp) noexcept;       
    NEFORCE_NODISCARD static bool is_space(char32_t cp) noexcept;       
    NEFORCE_NODISCARD static bool is_upper(char32_t cp) noexcept;       
    NEFORCE_NODISCARD static bool is_lower(char32_t cp) noexcept;       
    NEFORCE_NODISCARD static bool is_punct(char32_t cp) noexcept;       
    NEFORCE_NODISCARD static bool is_print(char32_t cp) noexcept;       
    NEFORCE_NODISCARD static bool is_titlecase(char32_t cp) noexcept;   
    NEFORCE_NODISCARD static bool is_white_space(char32_t cp) noexcept; 
 
    NEFORCE_NODISCARD static char32_t to_upper(char32_t cp) noexcept;     
    NEFORCE_NODISCARD static char32_t to_lower(char32_t cp) noexcept;     
    NEFORCE_NODISCARD static char32_t to_titlecase(char32_t cp) noexcept; 

    NEFORCE_NODISCARD int compare(const string& a, const string& b,
                                  collate_strength strength = collate_strength::tertiary) const;

    NEFORCE_NODISCARD string collation_key(const string& s) const;

    NEFORCE_NODISCARD string to_multibyte(const u32string& ucs4) const;

    NEFORCE_NODISCARD u32string to_ucs4(const string& mb) const;

    NEFORCE_NODISCARD string format_number(int64_t value) const;

    NEFORCE_NODISCARD string format_number(double value, int32_t fraction_digits = 2) const;

    NEFORCE_NODISCARD string format_currency(double value, const string& iso_4217_code) const;

    NEFORCE_NODISCARD string format_datetime(const datetime& dt, date_style ds = date_style::medium,
                                             time_style ts = time_style::medium) const;

    NEFORCE_NODISCARD string format_datetime(const datetime& dt, const string& pattern) const;

    NEFORCE_NODISCARD string format_datetime() const;

    NEFORCE_NODISCARD numeric_info numeric() const;

    NEFORCE_NODISCARD monetary_info monetary() const;

    NEFORCE_NODISCARD time_info time() const;

    NEFORCE_NODISCARD static vector<string> available_locales();

    NEFORCE_NODISCARD static vector<string> available_countries(const string& language);

    NEFORCE_NODISCARD static bool is_valid_locale(const string& name);

    NEFORCE_NODISCARD bool operator==(const locale& o) const noexcept { return name_ == o.name_; }

    NEFORCE_NODISCARD bool operator!=(const locale& o) const noexcept { return !(*this == o); }
};
 // Locale
 
NEFORCE_END_NAMESPACE__
#endif // NEFORCE_CORE_SYSTEM_LOCALE_HPP__