locid.h

Go to the documentation of this file.

/*
******************************************************************************
*
*   Copyright (C) 1996-2015, International Business Machines
*   Corporation and others.  All Rights Reserved.
*
******************************************************************************
*
* File locid.h
*
* Created by: Helena Shih
*
* Modification History:
*
*   Date        Name        Description
*   02/11/97    aliu        Changed gLocPath to fgLocPath and added methods to
*                           get and set it.
*   04/02/97    aliu        Made operator!= inline; fixed return value of getName().
*   04/15/97    aliu        Cleanup for AIX/Win32.
*   04/24/97    aliu        Numerous changes per code review.
*   08/18/98    stephen     Added tokenizeString(),changed getDisplayName()
*   09/08/98    stephen     Moved definition of kEmptyString for Mac Port
*   11/09/99    weiv        Added const char * getName() const;
*   04/12/00    srl         removing unicodestring api's and cached hash code
*   08/10/01    grhoten     Change the static Locales to accessor functions
******************************************************************************
*/
 
#ifndef LOCID_H
#define LOCID_H
 
#include "unicode/utypes.h"
#include "unicode/uobject.h"
#include "unicode/unistr.h"
#include "unicode/putil.h"
#include "unicode/uloc.h"
#include "unicode/strenum.h"
 
U_NAMESPACE_BEGIN
 
// Forward Declarations
void U_CALLCONV locale_available_init(); 
class U_COMMON_API Locale : public UObject {
public:
    static const Locale &U_EXPORT2 getRoot(void);
    static const Locale &U_EXPORT2 getEnglish(void);
    static const Locale &U_EXPORT2 getFrench(void);
    static const Locale &U_EXPORT2 getGerman(void);
    static const Locale &U_EXPORT2 getItalian(void);
    static const Locale &U_EXPORT2 getJapanese(void);
    static const Locale &U_EXPORT2 getKorean(void);
    static const Locale &U_EXPORT2 getChinese(void);
    static const Locale &U_EXPORT2 getSimplifiedChinese(void);
    static const Locale &U_EXPORT2 getTraditionalChinese(void);
 
    static const Locale &U_EXPORT2 getFrance(void);
    static const Locale &U_EXPORT2 getGermany(void);
    static const Locale &U_EXPORT2 getItaly(void);
    static const Locale &U_EXPORT2 getJapan(void);
    static const Locale &U_EXPORT2 getKorea(void);
    static const Locale &U_EXPORT2 getChina(void);
    static const Locale &U_EXPORT2 getPRC(void);
    static const Locale &U_EXPORT2 getTaiwan(void);
    static const Locale &U_EXPORT2 getUK(void);
    static const Locale &U_EXPORT2 getUS(void);
    static const Locale &U_EXPORT2 getCanada(void);
    static const Locale &U_EXPORT2 getCanadaFrench(void);
 
 
    Locale();
 
    Locale( const   char * language,
            const   char * country  = 0,
            const   char * variant  = 0,
            const   char * keywordsAndValues = 0);
 
    Locale(const    Locale& other);
 
 
    virtual ~Locale() ;
 
    Locale& operator=(const Locale& other);
 
    UBool   operator==(const    Locale&     other) const;
 
    UBool   operator!=(const    Locale&     other) const;
 
    Locale *clone() const;
 
#ifndef U_HIDE_SYSTEM_API
 
    static const Locale& U_EXPORT2 getDefault(void);
 
    static void U_EXPORT2 setDefault(const Locale& newLocale,
                                     UErrorCode&   success);
#endif  /* U_HIDE_SYSTEM_API */
 
    static Locale U_EXPORT2 createFromName(const char *name);
 
    static Locale U_EXPORT2 createCanonical(const char* name);
 
    inline const char *  getLanguage( ) const;
 
    inline const char *  getScript( ) const;
 
    inline const char *  getCountry( ) const;
 
    inline const char *  getVariant( ) const;
 
    inline const char * getName() const;
 
    const char * getBaseName() const;
 
 
    StringEnumeration * createKeywords(UErrorCode &status) const;
 
    int32_t getKeywordValue(const char* keywordName, char *buffer, int32_t bufferCapacity, UErrorCode &status) const;
 
    void setKeywordValue(const char* keywordName, const char* keywordValue, UErrorCode &status);
 
    const char * getISO3Language() const;
 
    const char * getISO3Country() const;
 
    uint32_t        getLCID(void) const;
 
#ifndef U_HIDE_DRAFT_API
 
    UBool isRightToLeft() const;
#endif  /* U_HIDE_DRAFT_API */
 
    UnicodeString&  getDisplayLanguage(UnicodeString&   dispLang) const;
 
    UnicodeString&  getDisplayLanguage( const   Locale&         displayLocale,
                                                UnicodeString&  dispLang) const;
 
    UnicodeString&  getDisplayScript(          UnicodeString& dispScript) const;
 
    UnicodeString&  getDisplayScript(  const   Locale&         displayLocale,
                                               UnicodeString&  dispScript) const;
 
    UnicodeString&  getDisplayCountry(          UnicodeString& dispCountry) const;
 
    UnicodeString&  getDisplayCountry(  const   Locale&         displayLocale,
                                                UnicodeString&  dispCountry) const;
 
    UnicodeString&  getDisplayVariant(      UnicodeString& dispVar) const;
 
    UnicodeString&  getDisplayVariant(  const   Locale&         displayLocale,
                                                UnicodeString&  dispVar) const;
 
    UnicodeString&  getDisplayName(         UnicodeString&  name) const;
 
    UnicodeString&  getDisplayName( const   Locale&         displayLocale,
                                            UnicodeString&  name) const;
 
    int32_t         hashCode(void) const;
 
    void setToBogus();
 
    UBool isBogus(void) const;
 
    static const Locale* U_EXPORT2 getAvailableLocales(int32_t& count);
 
    static const char* const* U_EXPORT2 getISOCountries();
 
    static const char* const* U_EXPORT2 getISOLanguages();
 
    static UClassID U_EXPORT2 getStaticClassID();
 
    virtual UClassID getDynamicClassID() const;
 
protected: /* only protected for testing purposes. DO NOT USE. */
#ifndef U_HIDE_INTERNAL_API
 
    void setFromPOSIXID(const char *posixID);
#endif  /* U_HIDE_INTERNAL_API */
 
private:
    Locale& init(const char* cLocaleID, UBool canonicalize);
 
    /*
     * Internal constructor to allow construction of a locale object with
     *   NO side effects.   (Default constructor tries to get
     *   the default locale.)
     */
    enum ELocaleType {
        eBOGUS
    };
    Locale(ELocaleType);
 
    static Locale *getLocaleCache(void);
 
    char language[ULOC_LANG_CAPACITY];
    char script[ULOC_SCRIPT_CAPACITY];
    char country[ULOC_COUNTRY_CAPACITY];
    int32_t variantBegin;
    char* fullName;
    char fullNameBuffer[ULOC_FULLNAME_CAPACITY];
    // name without keywords
    char* baseName;
    void initBaseName(UErrorCode& status);
 
    UBool fIsBogus;
 
    static const Locale &getLocale(int locid);
 
    friend Locale *locale_set_default_internal(const char *, UErrorCode& status);
 
    friend void U_CALLCONV locale_available_init();
};
 
inline UBool
Locale::operator!=(const    Locale&     other) const
{
    return !operator==(other);
}
 
inline const char *
Locale::getCountry() const
{
    return country;
}
 
inline const char *
Locale::getLanguage() const
{
    return language;
}
 
inline const char *
Locale::getScript() const
{
    return script;
}
 
inline const char *
Locale::getVariant() const
{
    return &baseName[variantBegin];
}
 
inline const char *
Locale::getName() const
{
    return fullName;
}
 
inline UBool
Locale::isBogus(void) const {
    return fIsBogus;
}
 
U_NAMESPACE_END
 
#endif