locid.h

Go to the documentation of this file.

/*
******************************************************************************
*
*   Copyright (C) 1996-2012, 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

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;
 
#ifndef U_HIDE_DRAFT_API
    void setKeywordValue(const char* keywordName, const char* keywordValue, UErrorCode &status);
#endif  /* U_HIDE_DRAFT_API */

    const char * getISO3Language() const;

    const char * getISO3Country() const;

    uint32_t        getLCID(void) const;

    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;
    char baseNameBuffer[ULOC_FULLNAME_CAPACITY];
 
    UBool fIsBogus;
 
    static const Locale &getLocale(int locid);

    friend Locale *locale_set_default_internal(const char *, UErrorCode& status);
};
 
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
{
    getBaseName(); // lazy init
    return &baseName[variantBegin];
}
 
inline const char *
Locale::getName() const
{
    return fullName;
}
 
inline UBool
Locale::isBogus(void) const {
    return fIsBogus;
}
 
U_NAMESPACE_END
 
#endif