]> git.saurik.com Git - apple/icu.git/blobdiff - icuSources/common/locid.cpp
ICU-8.11.2.tar.gz
[apple/icu.git] / icuSources / common / locid.cpp
index 8e9918830eaad37532f5cc01da3c5db7fa97dec2..cb8d59eb4c191226d697c54f0ad29d314e67e283 100644 (file)
@@ -1,6 +1,6 @@
 /*
  **********************************************************************
- *   Copyright (C) 1997-2003, International Business Machines
+ *   Copyright (C) 1997-2006, International Business Machines
  *   Corporation and others.  All Rights Reserved.
  **********************************************************************
 *
@@ -11,9 +11,9 @@
 * Modification History:
 *
 *   Date        Name        Description
-*   02/11/97    aliu        Changed gLocPath to fgDataDirectory and added 
+*   02/11/97    aliu        Changed gLocPath to fgDataDirectory and added
 *                           methods to get and set it.
-*   04/02/97    aliu        Made operator!= inline; fixed return value 
+*   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.
@@ -39,6 +39,8 @@
 #include "uhash.h"
 #include "ucln_cmn.h"
 
+#define LENGTHOF(array) (int32_t)(sizeof(array)/sizeof((array)[0]))
+
 static Locale*  availableLocaleList = NULL;
 static int32_t  availableLocaleListCount;
 typedef enum ELocalePos {
@@ -67,15 +69,27 @@ typedef enum ELocalePos {
     eMAX_LOCALES
 } ELocalePos;
 
-/* Use void * to make it properly aligned */
-/* Add 1 for rounding */
-// static void *gByteLocaleCache[(eMAX_LOCALES + 1) * sizeof(Locale) / sizeof(void*)];
-
-static Locale *gLocaleCache   = NULL;
-static Locale *gDefaultLocale = NULL;
+U_CFUNC int32_t locale_getKeywords(const char *localeID,
+            char prev,
+            char *keywords, int32_t keywordCapacity,
+            char *values, int32_t valuesCapacity, int32_t *valLen,
+            UBool valuesToo,
+            UErrorCode *status);
+
+static Locale        *gLocaleCache         = NULL;
+static const Locale  *gDefaultLocale       = NULL;
+static UHashtable    *gDefaultLocalesHashT = NULL;
+
+U_CDECL_BEGIN
+//
+// Deleter function for Locales owned by the default Locale hash table/
+//
+static void U_CALLCONV
+deleteLocale(void *obj) {
+    delete (Locale *) obj;
+}
 
-UBool
-locale_cleanup(void)
+static UBool U_CALLCONV locale_cleanup(void)
 {
     U_NAMESPACE_USE
 
@@ -89,40 +103,122 @@ locale_cleanup(void)
         delete [] gLocaleCache;
         gLocaleCache = NULL;
     }
-    if (gDefaultLocale) {
-        delete gDefaultLocale;
-        gDefaultLocale = NULL;
+
+    if (gDefaultLocalesHashT) {
+        uhash_close(gDefaultLocalesHashT);   // Automatically deletes all elements, using deleter func.
+        gDefaultLocalesHashT = NULL;
     }
+    gDefaultLocale = NULL;
+
     return TRUE;
 }
+U_CDECL_END
 
 U_NAMESPACE_BEGIN
-const char Locale::fgClassID=0;
+UOBJECT_DEFINE_RTTI_IMPLEMENTATION(Locale)
 
+//
+//  locale_set_default_internal.
+//
 void locale_set_default_internal(const char *id)
 {
     U_NAMESPACE_USE
-    Locale tempLocale(Locale::eBOGUS);
-
-    if (id == NULL) 
-    {
+    UErrorCode   status = U_ZERO_ERROR;
+    UBool canonicalize = FALSE;
+
+    // If given a NULL string for the locale id, grab the default
+    //   name from the system.
+    //   (Different from most other locale APIs, where a null name means use
+    //    the current ICU default locale.)
+    if (id == NULL) {
         umtx_lock(NULL);
         id = uprv_getDefaultLocaleID();
         umtx_unlock(NULL);
+        canonicalize = TRUE; // always canonicalize host ID
+    }
+
+    // put the locale id into a canonical form,
+    //   in preparation for looking up this locale in the hash table of
+    //   already-created locale objects.
+    //
+    status = U_ZERO_ERROR;
+    char localeNameBuf[512];
+
+    if (canonicalize) {
+        uloc_canonicalize(id, localeNameBuf, sizeof(localeNameBuf)-1, &status);
+    } else {
+        uloc_getName(id, localeNameBuf, sizeof(localeNameBuf)-1, &status);
     }
+    localeNameBuf[sizeof(localeNameBuf)-1] = 0;  // Force null termination in event of
+                                                 //   a long name filling the buffer.
+                                                 //   (long names are truncated.)
 
-    tempLocale.init(id);   // Note:  we do not want to hold the mutex through init(),
-                           //        which is a relatively large, complex function.
-                           //        Hence, the use of a temporary locale.
-    const Locale *defLocale = &Locale::getDefault();
-    
+    // Lazy creation of the hash table itself, if needed.
+    //
     umtx_lock(NULL);
-    Locale *ncDefLocale = (Locale *)defLocale;
-    *ncDefLocale = tempLocale;
+    UBool hashTableNeedsInit = (gDefaultLocalesHashT == NULL);
     umtx_unlock(NULL);
+    if (hashTableNeedsInit) {
+        status = U_ZERO_ERROR;
+        UHashtable *tHashTable = uhash_open(uhash_hashChars, uhash_compareChars, NULL, &status);
+        if (U_FAILURE(status)) {
+            return;
+        }
+        uhash_setValueDeleter(tHashTable, deleteLocale);
+        umtx_lock(NULL);
+        if (gDefaultLocalesHashT == NULL) {
+            gDefaultLocalesHashT = tHashTable;
+            ucln_common_registerCleanup(UCLN_COMMON_LOCALE, locale_cleanup);
+            umtx_unlock(NULL);
+        } else {
+            umtx_unlock(NULL);
+            uhash_close(tHashTable);
+        }
+    }
+
+    // Hash table lookup, key is the locale full name
+    umtx_lock(NULL);
+    Locale *newDefault = (Locale *)uhash_get(gDefaultLocalesHashT, localeNameBuf);
+    if (newDefault != NULL) {
+        // We have the requested locale in the hash table already.
+        // Just set it as default.  Inside the mutex lock, for those troublesome processors.
+        gDefaultLocale = newDefault;
+        umtx_unlock(NULL);
+    } else {
+        umtx_unlock(NULL);
+        // We haven't seen this locale id before.
+        // Create a new Locale object for it.
+        newDefault = new Locale(Locale::eBOGUS);
+        if (newDefault == NULL) {
+            // No way to report errors from here.
+            return;
+        }
+        newDefault->init(localeNameBuf, FALSE);
+
+        // Add newly created Locale to the hash table of default Locales
+        const char *key = newDefault->getName();
+        U_ASSERT(uprv_strcmp(key, localeNameBuf) == 0);
+        umtx_lock(NULL);
+        const Locale *hashTableVal = (const Locale *)uhash_get(gDefaultLocalesHashT, key);
+        if (hashTableVal == NULL) {
+            uhash_put(gDefaultLocalesHashT, (void *)key, newDefault, &status);
+            gDefaultLocale = newDefault;
+            umtx_unlock(NULL);
+            // ignore errors from hash table insert.  (Couldn't do anything anyway)
+            // We can still set the default Locale,
+            //  it just wont be cached, and will eventually leak.
+        } else {
+            // Some other thread raced us through here, and got the new Locale
+            //   into the hash table before us.  Use that one.
+            gDefaultLocale = hashTableVal;  // Assignment to gDefaultLocale must happen inside mutex
+            umtx_unlock(NULL);
+            delete newDefault;
+        }
+    }
 }
 U_NAMESPACE_END
 
+
 /* sfb 07/21/99 */
 U_CFUNC void
 locale_set_default(const char *id)
@@ -149,36 +245,46 @@ U_NAMESPACE_BEGIN
 #define SEP_CHAR '_'
 
 Locale::~Locale()
-{   
+{
     /*if fullName is on the heap, we free it*/
-    if (fullName != fullNameBuffer) 
+    if (fullName != fullNameBuffer)
     {
         uprv_free(fullName);
         fullName = NULL;
     }
+    if (baseName && baseName != baseNameBuffer) {
+        uprv_free(baseName);
+        baseName = NULL;
+    }
 }
 
 Locale::Locale()
-    : UObject(), fullName(fullNameBuffer)
+    : UObject(), fullName(fullNameBuffer), baseName(NULL)
 {
-    init(NULL);
+    init(NULL, FALSE);
 }
 
-Locale::Locale(Locale::ELocaleType t) 
-    : UObject(), fullName(fullNameBuffer)
+/*
+ * Internal constructor to allow construction of a locale object with
+ *   NO side effects.   (Default constructor tries to get
+ *   the default locale.)
+ */
+Locale::Locale(Locale::ELocaleType)
+    : UObject(), fullName(fullNameBuffer), baseName(NULL)
 {
     setToBogus();
 }
 
 
-Locale::Locale( const   char * newLanguage, 
-                const   char * newCountry, 
-                const   char * newVariant) 
-    : UObject(), fullName(fullNameBuffer)
+Locale::Locale( const   char * newLanguage,
+                const   char * newCountry,
+                const   char * newVariant,
+                const   char * newKeywords)
+    : UObject(), fullName(fullNameBuffer), baseName(NULL)
 {
     if( (newLanguage==NULL) && (newCountry == NULL) && (newVariant == NULL) )
     {
-        init(NULL); /* shortcut */
+        init(NULL, FALSE); /* shortcut */
     }
     else
     {
@@ -189,6 +295,7 @@ Locale::Locale( const   char * newLanguage,
         int32_t lsize = 0;
         int32_t csize = 0;
         int32_t vsize = 0;
+        int32_t ksize = 0;
         char    *p;
 
         // Calculate the size of the resulting string.
@@ -215,7 +322,7 @@ Locale::Locale( const   char * newLanguage,
             {
                 newVariant++;
             }
-            
+
             // remove trailing _'s
             vsize = (int32_t)uprv_strlen(newVariant);
             while( (vsize>1) && (newVariant[vsize-1] == SEP_CHAR) )
@@ -232,18 +339,25 @@ Locale::Locale( const   char * newLanguage,
         // Separator rules:
         if ( vsize > 0 )
         {
-            size += 2;  // at least: __v 
+            size += 2;  // at least: __v
         }
         else if ( csize > 0 )
         {
-            size += 1;  // at least: _v 
+            size += 1;  // at least: _v
+        }
+
+        if ( newKeywords != NULL)
+        {
+            ksize = (int32_t)uprv_strlen(newKeywords);
+            size += ksize + 1;
         }
 
+
         //  NOW we have the full locale string..
 
         /*if the whole string is longer than our internal limit, we need
         to go to the heap for temporary buffers*/
-        if (size > ULOC_FULLNAME_CAPACITY)
+        if (size >= ULOC_FULLNAME_CAPACITY)
         {
             togo_heap = (char *)uprv_malloc(sizeof(char)*(size+1));
             togo = togo_heap;
@@ -269,7 +383,7 @@ Locale::Locale( const   char * newLanguage,
         }
 
         if ( csize != 0 )
-        { 
+        {
             uprv_strcpy(p, newCountry);
             p += csize;
         }
@@ -278,14 +392,29 @@ Locale::Locale( const   char * newLanguage,
         {
             *p++ = SEP_CHAR; // at least: __v
 
-            uprv_strncpy(p, newVariant, vsize);  // Must use strncpy because 
+            uprv_strncpy(p, newVariant, vsize);  // Must use strncpy because
             p += vsize;                          // of trimming (above).
             *p = 0; // terminate
         }
 
+        if ( ksize != 0)
+        {
+            if (uprv_strchr(newKeywords, '=')) {
+                *p++ = '@'; /* keyword parsing */
+            }
+            else {
+                *p++ = '_'; /* Variant parsing with a script */
+                if ( vsize == 0) {
+                    *p++ = '_'; /* No country found */
+                }
+            }
+            uprv_strcpy(p, newKeywords);
+            p += ksize;
+        }
+
         // Parse it, because for example 'language' might really be a complete
         // string.
-        init(togo);
+        init(togo, FALSE);
 
         if (togo_heap) {
             uprv_free(togo_heap);
@@ -294,7 +423,7 @@ Locale::Locale( const   char * newLanguage,
 }
 
 Locale::Locale(const Locale &other)
-    : UObject(other), fullName(fullNameBuffer)
+    : UObject(other), fullName(fullNameBuffer), baseName(NULL)
 {
     *this = other;
 }
@@ -320,12 +449,26 @@ Locale &Locale::operator=(const Locale &other)
     if(other.fullName != other.fullNameBuffer) {
         fullName = (char *)uprv_malloc(sizeof(char)*(uprv_strlen(other.fullName)+1));
     }
-
     /* Copy the full name */
     uprv_strcpy(fullName, other.fullName);
 
+    /* baseName is the cached result of getBaseName.  if 'other' has a
+       baseName and it fits in baseNameBuffer, then copy it. otherwise set
+       it to NULL, and let the user lazy-create it (in getBaseName) if they
+       want it. */
+    if(baseName && baseName != baseNameBuffer) {
+        uprv_free(baseName);
+    }
+    baseName = NULL;
+
+    if(other.baseName == other.baseNameBuffer) {
+        uprv_strcpy(baseNameBuffer, other.baseNameBuffer);
+        baseName = baseNameBuffer;
+    }
+
     /* Copy the language and country fields */
     uprv_strcpy(language, other.language);
+    uprv_strcpy(script, other.script);
     uprv_strcpy(country, other.country);
 
     /* The variantBegin is an offset into fullName, just copy it */
@@ -334,6 +477,11 @@ Locale &Locale::operator=(const Locale &other)
     return *this;
 }
 
+Locale *
+Locale::clone() const {
+    return new Locale(*this);
+}
+
 UBool
 Locale::operator==( const   Locale& other) const
 {
@@ -341,7 +489,7 @@ Locale::operator==( const   Locale& other) const
 }
 
 /*This function initializes a Locale from a C locale ID*/
-Locale& Locale::init(const char* localeID)
+Locale& Locale::init(const char* localeID, UBool canonicalize)
 {
     fIsBogus = FALSE;
     /* Free our current storage */
@@ -350,11 +498,20 @@ Locale& Locale::init(const char* localeID)
         fullName = fullNameBuffer;
     }
 
+    if(baseName && baseName != baseNameBuffer) {
+        uprv_free(baseName);
+        baseName = NULL;
+    }
+
     // not a loop:
     // just an easy way to have a common error-exit
     // without goto and without another function
     do {
-        char *separator, *prev;
+        char *separator;
+        char *field[5] = {0};
+        int32_t fieldLen[5] = {0};
+        int32_t fieldIdx;
+        int32_t variantField;
         int32_t length;
         UErrorCode err;
 
@@ -363,10 +520,16 @@ Locale& Locale::init(const char* localeID)
             return *this = getDefault();
         }
 
+        /* preset all fields to empty */
+        language[0] = script[0] = country[0] = 0;
+
         // "canonicalize" the locale ID to ICU/Java format
         err = U_ZERO_ERROR;
-        length = uloc_getName(localeID, fullName, sizeof(fullNameBuffer), &err);
-        if(U_FAILURE(err) || err == U_STRING_NOT_TERMINATED_WARNING) {
+        length = canonicalize ?
+            uloc_canonicalize(localeID, fullName, sizeof(fullNameBuffer), &err) :
+            uloc_getName(localeID, fullName, sizeof(fullNameBuffer), &err);
+
+        if(err == U_BUFFER_OVERFLOW_ERROR || length >= (int32_t)sizeof(fullNameBuffer)) {
             /*Go to heap for the fullName if necessary*/
             fullName = (char *)uprv_malloc(sizeof(char)*(length + 1));
             if(fullName == 0) {
@@ -374,62 +537,74 @@ Locale& Locale::init(const char* localeID)
                 break; // error: out of memory
             }
             err = U_ZERO_ERROR;
-            length = uloc_getName(localeID, fullName, length + 1, &err);
+            length = canonicalize ?
+                uloc_canonicalize(localeID, fullName, length+1, &err) :
+                uloc_getName(localeID, fullName, length+1, &err);
         }
         if(U_FAILURE(err) || err == U_STRING_NOT_TERMINATED_WARNING) {
             /* should never occur */
             break;
         }
 
-        /* preset all fields to empty */
-        language[0] = country[0] = 0;
-        variantBegin = (int32_t)uprv_strlen(fullName);
-
-        /* after uloc_getName() we know that only '_' are separators */
-        separator = uprv_strchr(fullName, SEP_CHAR);
-        if(separator != 0) {
-            /* there is a country field */
-            length = (int32_t)(separator - fullName);
-            if(length > 0) {
-                if(length >= (int32_t)sizeof(language)) {
-                    break; // error: language code too long
-                }
-                uprv_memcpy(language, fullName, length);
-            }
-            language[length] = 0;
-
-            prev = separator + 1;
-            separator = uprv_strchr(prev, SEP_CHAR);
-            if(separator != 0) {
-                /* there is a variant field */
-                length = (int32_t)(separator - prev);
-                if(length > 0) {
-                    if(length >= (int32_t)sizeof(country)) {
-                        break; // error: country code too long
-                    }
-                    uprv_memcpy(country, prev, length);
-                }
-                country[length] = 0;
+        variantBegin = length;
 
-                variantBegin = (int32_t)((separator + 1) - fullName);
-            } else {
-                /* variantBegin==strlen(fullName), length==strlen(language)==prev-1-fullName */
-                if((variantBegin - length - 1) >= (int32_t)sizeof(country)) {
-                    break; // error: country code too long
-                }
-                uprv_strcpy(country, prev);
+        /* after uloc_getName/canonicalize() we know that only '_' are separators */
+        separator = field[0] = fullName;
+        fieldIdx = 1;
+        while ((separator = uprv_strchr(field[fieldIdx-1], SEP_CHAR)) && fieldIdx < (int32_t)(sizeof(field)/sizeof(field[0]))-1) {
+            field[fieldIdx] = separator + 1;
+            fieldLen[fieldIdx-1] = (int32_t)(separator - field[fieldIdx-1]);
+            fieldIdx++;
+        }
+        // variant may contain @foo or .foo POSIX cruft; remove it
+        separator = uprv_strchr(field[fieldIdx-1], '@');
+        char* sep2 = uprv_strchr(field[fieldIdx-1], '.');
+        if (separator!=NULL || sep2!=NULL) {
+            if (separator==NULL || (sep2!=NULL && separator > sep2)) {
+                separator = sep2;
             }
+            fieldLen[fieldIdx-1] = (int32_t)(separator - field[fieldIdx-1]);
         } else {
-            /* variantBegin==strlen(fullName) */
-            if(variantBegin >= (int32_t)sizeof(language)) {
-                break; // error: language code too long
+            fieldLen[fieldIdx-1] = length - (int32_t)(field[fieldIdx-1] - fullName);
+        }
+
+        if (fieldLen[0] >= (int32_t)(sizeof(language))
+            || (fieldLen[1] == 4 && fieldLen[2] >= (int32_t)(sizeof(country)))
+            || (fieldLen[1] != 4 && fieldLen[1] >= (int32_t)(sizeof(country))))
+        {
+            break; // error: one of the fields is too long
+        }
+
+        variantField = 2; /* Usually the 2nd one, except when a script is used. */
+        if (fieldLen[0] > 0) {
+            /* We have a language */
+            uprv_memcpy(language, fullName, fieldLen[0]);
+            language[fieldLen[0]] = 0;
+        }
+        if (fieldLen[1] == 4) {
+            /* We have at least a script */
+            uprv_memcpy(script, field[1], fieldLen[1]);
+            script[fieldLen[1]] = 0;
+            variantField = 3;
+            if (fieldLen[2] > 0) {
+                /* We have a country */
+                uprv_memcpy(country, field[2], fieldLen[2]);
+                country[fieldLen[2]] = 0;
             }
-            uprv_strcpy(language, fullName);
+        }
+        else if (fieldLen[1] > 0) {
+            /* We have a country and no script */
+            uprv_memcpy(country, field[1], fieldLen[1]);
+            country[fieldLen[1]] = 0;
+        }
+        if (variantField > 0 && fieldLen[variantField] > 0) {
+            /* We have a variant */
+            variantBegin = (int32_t)(field[variantField] - fullName);
         }
 
         // successful end of init()
         return *this;
-    } while(0);
+    } while(0); /*loop doesn't iterate*/
 
     // when an error occurs, then set this object to "bogus" (there is no UErrorCode here)
     setToBogus();
@@ -438,75 +613,70 @@ Locale& Locale::init(const char* localeID)
 }
 
 int32_t
-Locale::hashCode() const 
+Locale::hashCode() const
 {
     UHashTok hashKey;
     hashKey.pointer = fullName;
     return uhash_hashChars(hashKey);
 }
 
-void 
+void
 Locale::setToBogus() {
-  /* Free our current storage */
-  if(fullName != fullNameBuffer) {
-      uprv_free(fullName);
-      fullName = fullNameBuffer;
-  }
-  *fullNameBuffer = 0;
-  *language = 0;
-  *country = 0;
-  fIsBogus = TRUE;
+    /* Free our current storage */
+    if(fullName != fullNameBuffer) {
+        uprv_free(fullName);
+        fullName = fullNameBuffer;
+    }
+    *fullNameBuffer = 0;
+    *language = 0;
+    *script = 0;
+    *country = 0;
+    fIsBogus = TRUE;
 }
 
-const Locale&
-Locale::getDefault() 
+const Locale& U_EXPORT2
+Locale::getDefault()
 {
+    const Locale *retLocale;
     umtx_lock(NULL);
-    UBool needInit = (gDefaultLocale == NULL);
+    retLocale = gDefaultLocale;
     umtx_unlock(NULL);
-    if (needInit) {
-        Locale *tLocale = new Locale(Locale::eBOGUS);
-        if (tLocale != NULL) {
-            const char *cLocale;
-
-            umtx_lock(NULL);
-            /* uprv_getDefaultLocaleID is not thread safe, so we surround it with a mutex */
-            cLocale = uprv_getDefaultLocaleID();
-            umtx_unlock(NULL);
-
-            tLocale->init(cLocale);
-            umtx_lock(NULL);
-            if (gDefaultLocale == NULL) {
-                gDefaultLocale = tLocale;
-                tLocale = NULL;
-            }
-            umtx_unlock(NULL);
-            delete tLocale;
-        }
+    if (retLocale == NULL) {
+        locale_set_default_internal(NULL);
+        umtx_lock(NULL);
+        // Need a mutex  in case some other thread set a new
+        // default inbetween when we set and when we get the new default.  For
+        // processors with weak memory coherency, we might not otherwise see all
+        // of the newly created new default locale.
+        retLocale = gDefaultLocale;
+        umtx_unlock(NULL);
     }
-    return *gDefaultLocale;
+    return *retLocale;
 }
 
-void 
-Locale::setDefault( const   Locale&     newLocale, 
-                            UErrorCode&  status) 
+
+
+void U_EXPORT2
+Locale::setDefault( const   Locale&     newLocale,
+                            UErrorCode&  status)
 {
-    if (U_FAILURE(status))
+    if (U_FAILURE(status)) {
         return;
-    
-    const Locale *defLocale = &Locale::getDefault();
-    umtx_lock(NULL);
-    Locale *ncDefLocale = (Locale *)defLocale;
-    *ncDefLocale = newLocale;
-    umtx_unlock(NULL);
+    }
+
+    /* Set the default from the full name string of the supplied locale.
+     * This is a convenient way to access the default locale caching mechanisms.
+     */
+    const char *localeID = newLocale.getName();
+    locale_set_default_internal(localeID);
 }
 
-Locale
+Locale U_EXPORT2
 Locale::createFromName (const char *name)
 {
     if (name) {
-        Locale l;
-        l.init(name);
+        Locale l("");
+        l.init(name, FALSE);
         return l;
     }
     else {
@@ -514,6 +684,12 @@ Locale::createFromName (const char *name)
     }
 }
 
+Locale U_EXPORT2
+Locale::createCanonical(const char* name) {
+    Locale loc("");
+    loc.init(name, TRUE);
+    return loc;
+}
 
 const char *
 Locale::getISO3Language() const
@@ -535,13 +711,13 @@ Locale::getISO3Country() const
  * in an incorrect format, 0 is returned.  The LocaleID is for use in
  * Windows (it is an LCID), but is available on all platforms.
  */
-uint32_t 
+uint32_t
 Locale::getLCID() const
 {
     return uloc_getLCID(fullName);
 }
 
-UnicodeString& 
+UnicodeString&
 Locale::getDisplayLanguage(UnicodeString& dispLang) const
 {
     return this->getDisplayLanguage(getDefault(), dispLang);
@@ -569,7 +745,7 @@ Locale::getDisplayLanguage(const Locale &displayLocale,
     length=uloc_getDisplayLanguage(fullName, displayLocale.fullName,
                                    buffer, result.getCapacity(),
                                    &errorCode);
-    result.releaseBuffer(length);
+    result.releaseBuffer(U_SUCCESS(errorCode) ? length : 0);
 
     if(errorCode==U_BUFFER_OVERFLOW_ERROR) {
         buffer=result.getBuffer(length);
@@ -581,17 +757,53 @@ Locale::getDisplayLanguage(const Locale &displayLocale,
         length=uloc_getDisplayLanguage(fullName, displayLocale.fullName,
                                        buffer, result.getCapacity(),
                                        &errorCode);
-        result.releaseBuffer(length);
+        result.releaseBuffer(U_SUCCESS(errorCode) ? length : 0);
     }
 
-    if(U_FAILURE(errorCode)) {
+    return result;
+}
+
+UnicodeString&
+Locale::getDisplayScript(UnicodeString& dispScript) const
+{
+    return this->getDisplayScript(getDefault(), dispScript);
+}
+
+UnicodeString&
+Locale::getDisplayScript(const Locale &displayLocale,
+                          UnicodeString &result) const {
+    UChar *buffer;
+    UErrorCode errorCode=U_ZERO_ERROR;
+    int32_t length;
+
+    buffer=result.getBuffer(ULOC_FULLNAME_CAPACITY);
+    if(buffer==0) {
         result.truncate(0);
+        return result;
+    }
+
+    length=uloc_getDisplayScript(fullName, displayLocale.fullName,
+                                  buffer, result.getCapacity(),
+                                  &errorCode);
+    result.releaseBuffer(U_SUCCESS(errorCode) ? length : 0);
+
+    if(errorCode==U_BUFFER_OVERFLOW_ERROR) {
+        buffer=result.getBuffer(length);
+        if(buffer==0) {
+            result.truncate(0);
+            return result;
+        }
+        errorCode=U_ZERO_ERROR;
+        length=uloc_getDisplayScript(fullName, displayLocale.fullName,
+                                      buffer, result.getCapacity(),
+                                      &errorCode);
+        result.releaseBuffer(U_SUCCESS(errorCode) ? length : 0);
     }
 
     return result;
 }
 
-UnicodeString& 
+UnicodeString&
 Locale::getDisplayCountry(UnicodeString& dispCntry) const
 {
     return this->getDisplayCountry(getDefault(), dispCntry);
@@ -613,7 +825,7 @@ Locale::getDisplayCountry(const Locale &displayLocale,
     length=uloc_getDisplayCountry(fullName, displayLocale.fullName,
                                   buffer, result.getCapacity(),
                                   &errorCode);
-    result.releaseBuffer(length);
+    result.releaseBuffer(U_SUCCESS(errorCode) ? length : 0);
 
     if(errorCode==U_BUFFER_OVERFLOW_ERROR) {
         buffer=result.getBuffer(length);
@@ -625,17 +837,13 @@ Locale::getDisplayCountry(const Locale &displayLocale,
         length=uloc_getDisplayCountry(fullName, displayLocale.fullName,
                                       buffer, result.getCapacity(),
                                       &errorCode);
-        result.releaseBuffer(length);
-    }
-
-    if(U_FAILURE(errorCode)) {
-        result.truncate(0);
+        result.releaseBuffer(U_SUCCESS(errorCode) ? length : 0);
     }
 
     return result;
 }
 
-UnicodeString& 
+UnicodeString&
 Locale::getDisplayVariant(UnicodeString& dispVar) const
 {
     return this->getDisplayVariant(getDefault(), dispVar);
@@ -657,7 +865,7 @@ Locale::getDisplayVariant(const Locale &displayLocale,
     length=uloc_getDisplayVariant(fullName, displayLocale.fullName,
                                   buffer, result.getCapacity(),
                                   &errorCode);
-    result.releaseBuffer(length);
+    result.releaseBuffer(U_SUCCESS(errorCode) ? length : 0);
 
     if(errorCode==U_BUFFER_OVERFLOW_ERROR) {
         buffer=result.getBuffer(length);
@@ -669,17 +877,13 @@ Locale::getDisplayVariant(const Locale &displayLocale,
         length=uloc_getDisplayVariant(fullName, displayLocale.fullName,
                                       buffer, result.getCapacity(),
                                       &errorCode);
-        result.releaseBuffer(length);
-    }
-
-    if(U_FAILURE(errorCode)) {
-        result.truncate(0);
+        result.releaseBuffer(U_SUCCESS(errorCode) ? length : 0);
     }
 
     return result;
 }
 
-UnicodeString& 
+UnicodeString&
 Locale::getDisplayName( UnicodeString& name ) const
 {
     return this->getDisplayName(getDefault(), name);
@@ -701,7 +905,7 @@ Locale::getDisplayName(const Locale &displayLocale,
     length=uloc_getDisplayName(fullName, displayLocale.fullName,
                                buffer, result.getCapacity(),
                                &errorCode);
-    result.releaseBuffer(length);
+    result.releaseBuffer(U_SUCCESS(errorCode) ? length : 0);
 
     if(errorCode==U_BUFFER_OVERFLOW_ERROR) {
         buffer=result.getBuffer(length);
@@ -713,23 +917,19 @@ Locale::getDisplayName(const Locale &displayLocale,
         length=uloc_getDisplayName(fullName, displayLocale.fullName,
                                    buffer, result.getCapacity(),
                                    &errorCode);
-        result.releaseBuffer(length);
-    }
-
-    if(U_FAILURE(errorCode)) {
-        result.truncate(0);
+        result.releaseBuffer(U_SUCCESS(errorCode) ? length : 0);
     }
 
     return result;
 }
-const Locale*
-Locale::getAvailableLocales(int32_t& count) 
+const Locale* U_EXPORT2
+Locale::getAvailableLocales(int32_t& count)
 {
     // for now, there is a hardcoded list, so just walk through that list and set it up.
     umtx_lock(NULL);
     UBool needInit = availableLocaleList == 0;
     umtx_unlock(NULL);
-    
+
     if (needInit) {
         int32_t locCount = uloc_countAvailable();
         Locale *newLocaleList = 0;
@@ -737,20 +937,22 @@ Locale::getAvailableLocales(int32_t& count)
            newLocaleList = new Locale[locCount];
         }
         if (newLocaleList == NULL) {
+            count = 0;
             return NULL;
         }
-      
+
         count = locCount;
-      
+
         while(--locCount >= 0) {
             newLocaleList[locCount].setFromPOSIXID(uloc_getAvailable(locCount));
         }
-      
+
         umtx_lock(NULL);
         if(availableLocaleList == 0) {
             availableLocaleListCount = count;
             availableLocaleList = newLocaleList;
             newLocaleList = NULL;
+            ucln_common_registerCleanup(UCLN_COMMON_LOCALE, locale_cleanup);
         }
         umtx_unlock(NULL);
         delete []newLocaleList;
@@ -759,144 +961,144 @@ Locale::getAvailableLocales(int32_t& count)
     return availableLocaleList;
 }
 
-const char* const* Locale::getISOCountries()
+const char* const* U_EXPORT2 Locale::getISOCountries()
 {
     return uloc_getISOCountries();
 }
 
-const char* const* Locale::getISOLanguages()
+const char* const* U_EXPORT2 Locale::getISOLanguages()
 {
     return uloc_getISOLanguages();
 }
 
-// Set the locale's data based on a posix id. 
+// Set the locale's data based on a posix id.
 void Locale::setFromPOSIXID(const char *posixID)
 {
-    init(posixID);
+    init(posixID, TRUE);
 }
 
-const Locale &
+const Locale & U_EXPORT2
 Locale::getEnglish(void)
 {
     return getLocale(eENGLISH);
 }
 
-const Locale &
+const Locale & U_EXPORT2
 Locale::getFrench(void)
 {
     return getLocale(eFRENCH);
 }
 
-const Locale &
+const Locale & U_EXPORT2
 Locale::getGerman(void)
 {
     return getLocale(eGERMAN);
 }
 
-const Locale &
+const Locale & U_EXPORT2
 Locale::getItalian(void)
 {
     return getLocale(eITALIAN);
 }
 
-const Locale &
+const Locale & U_EXPORT2
 Locale::getJapanese(void)
 {
     return getLocale(eJAPANESE);
 }
 
-const Locale &
+const Locale & U_EXPORT2
 Locale::getKorean(void)
 {
     return getLocale(eKOREAN);
 }
 
-const Locale &
+const Locale & U_EXPORT2
 Locale::getChinese(void)
 {
     return getLocale(eCHINESE);
 }
 
-const Locale &
+const Locale & U_EXPORT2
 Locale::getSimplifiedChinese(void)
 {
     return getLocale(eCHINA);
 }
 
-const Locale &
+const Locale & U_EXPORT2
 Locale::getTraditionalChinese(void)
 {
     return getLocale(eTAIWAN);
 }
 
 
-const Locale &
+const Locale & U_EXPORT2
 Locale::getFrance(void)
 {
     return getLocale(eFRANCE);
 }
 
-const Locale &
+const Locale & U_EXPORT2
 Locale::getGermany(void)
 {
     return getLocale(eGERMANY);
 }
 
-const Locale &
+const Locale & U_EXPORT2
 Locale::getItaly(void)
 {
     return getLocale(eITALY);
 }
 
-const Locale &
+const Locale & U_EXPORT2
 Locale::getJapan(void)
 {
     return getLocale(eJAPAN);
 }
 
-const Locale &
+const Locale & U_EXPORT2
 Locale::getKorea(void)
 {
     return getLocale(eKOREA);
 }
 
-const Locale &
+const Locale & U_EXPORT2
 Locale::getChina(void)
 {
     return getLocale(eCHINA);
 }
 
-const Locale &
+const Locale & U_EXPORT2
 Locale::getPRC(void)
 {
     return getLocale(eCHINA);
 }
 
-const Locale &
+const Locale & U_EXPORT2
 Locale::getTaiwan(void)
 {
     return getLocale(eTAIWAN);
 }
 
-const Locale &
+const Locale & U_EXPORT2
 Locale::getUK(void)
 {
     return getLocale(eUK);
 }
 
-const Locale &
+const Locale & U_EXPORT2
 Locale::getUS(void)
 {
     return getLocale(eUS);
 }
 
-const Locale &
+const Locale & U_EXPORT2
 Locale::getCanada(void)
 {
     return getLocale(eCANADA);
 }
 
-const Locale &
+const Locale & U_EXPORT2
 Locale::getCanadaFrench(void)
 {
     return getLocale(eCANADA_FRENCH);
@@ -906,13 +1108,13 @@ const Locale &
 Locale::getLocale(int locid)
 {
     Locale *localeCache = getLocaleCache();
-    U_ASSERT(locid < eMAX_LOCALES);
+    U_ASSERT((locid < eMAX_LOCALES)&&(locid>=0));
     if (localeCache == NULL) {
         // Failure allocating the locale cache.
         //   The best we can do is return a NULL reference.
         locid = 0;
     }
-    return localeCache[locid];
+    return localeCache[locid]; /*operating on NULL*/
 }
 
 /*
@@ -925,9 +1127,9 @@ Locale::getLocaleCache(void)
     umtx_lock(NULL);
     UBool needInit = (gLocaleCache == NULL);
     umtx_unlock(NULL);
-    
+
     if (needInit) {
-        Locale *tLocaleCache = new Locale[eMAX_LOCALES];
+        Locale *tLocaleCache = new Locale[(int)eMAX_LOCALES];
         if (tLocaleCache == NULL) {
             return NULL;
         }
@@ -949,11 +1151,12 @@ Locale::getLocaleCache(void)
         tLocaleCache[eUS]            = Locale("en", "US");
         tLocaleCache[eCANADA]        = Locale("en", "CA");
         tLocaleCache[eCANADA_FRENCH] = Locale("fr", "CA");
-        
+
         umtx_lock(NULL);
         if (gLocaleCache == NULL) {
             gLocaleCache = tLocaleCache;
             tLocaleCache = NULL;
+            ucln_common_registerCleanup(UCLN_COMMON_LOCALE, locale_cleanup);
         }
         umtx_unlock(NULL);
         if (tLocaleCache) {
@@ -963,5 +1166,136 @@ Locale::getLocaleCache(void)
     return gLocaleCache;
 }
 
+class KeywordEnumeration : public StringEnumeration {
+private:
+    char *keywords;
+    char *current;
+    int32_t length;
+    UnicodeString currUSKey;
+    static const char fgClassID;/* Warning this is used beyond the typical RTTI usage. */
+
+public:
+    static UClassID U_EXPORT2 getStaticClassID(void) { return (UClassID)&fgClassID; }
+    virtual UClassID getDynamicClassID(void) const { return getStaticClassID(); }
+public:
+    KeywordEnumeration(const char *keys, int32_t keywordLen, int32_t currentIndex, UErrorCode &status)
+        : keywords((char *)&fgClassID), current((char *)&fgClassID), length(0) {
+        if(U_SUCCESS(status) && keywordLen != 0) {
+            if(keys == NULL || keywordLen < 0) {
+                status = U_ILLEGAL_ARGUMENT_ERROR;
+            } else {
+                keywords = (char *)uprv_malloc(keywordLen+1);
+                if (keywords == NULL) {
+                    status = U_MEMORY_ALLOCATION_ERROR;
+                }
+                else {
+                    uprv_memcpy(keywords, keys, keywordLen);
+                    keywords[keywordLen] = 0;
+                    current = keywords + currentIndex;
+                    length = keywordLen;
+                }
+            }
+        }
+    }
+
+    virtual ~KeywordEnumeration() {
+        uprv_free(keywords);
+    }
+
+    virtual StringEnumeration * clone() const
+    {
+        UErrorCode status = U_ZERO_ERROR;
+        return new KeywordEnumeration(keywords, length, (int32_t)(current - keywords), status);
+    }
+
+    virtual int32_t count(UErrorCode &/*status*/) const {
+        char *kw = keywords;
+        int32_t result = 0;
+        while(*kw) {
+            result++;
+            kw += uprv_strlen(kw)+1;
+        }
+        return result;
+    }
+
+    virtual const char* next(int32_t* resultLength, UErrorCode& status) {
+        const char* result;
+        int32_t len;
+        if(U_SUCCESS(status) && *current != 0) {
+            result = current;
+            len = (int32_t)uprv_strlen(current);
+            current += len+1;
+            if(resultLength != NULL) {
+                *resultLength = len;
+            }
+        } else {
+            if(resultLength != NULL) {
+                *resultLength = 0;
+            }
+            result = NULL;
+        }
+        return result;
+    }
+
+    virtual const UnicodeString* snext(UErrorCode& status) {
+        int32_t resultLength = 0;
+        const char *s = next(&resultLength, status);
+        return setChars(s, resultLength, status);
+    }
+
+    virtual void reset(UErrorCode& /*status*/) {
+        current = keywords;
+    }
+};
+
+const char KeywordEnumeration::fgClassID = '\0';
+
+StringEnumeration *
+Locale::createKeywords(UErrorCode &status) const
+{
+    char keywords[256];
+    int32_t keywordCapacity = 256;
+    StringEnumeration *result = NULL;
+
+    const char* variantStart = uprv_strchr(fullName, '@');
+    const char* assignment = uprv_strchr(fullName, '=');
+    if(variantStart) {
+        if(assignment > variantStart) {
+            int32_t keyLen = locale_getKeywords(variantStart+1, '@', keywords, keywordCapacity, NULL, 0, NULL, FALSE, &status);
+            if(keyLen) {
+                result = new KeywordEnumeration(keywords, keyLen, 0, status);
+            }
+        } else {
+            status = U_INVALID_FORMAT_ERROR;
+        }
+    }
+    return result;
+}
+
+int32_t
+Locale::getKeywordValue(const char* keywordName, char *buffer, int32_t bufLen, UErrorCode &status) const
+{
+    return uloc_getKeywordValue(fullName, keywordName, buffer, bufLen, &status);
+}
+
+const char *
+Locale::getBaseName() const
+{
+    // lazy init
+    UErrorCode status = U_ZERO_ERROR;
+    // semantically const
+    if(baseName == 0) {
+        ((Locale *)this)->baseName = ((Locale *)this)->baseNameBuffer;
+        int32_t baseNameSize = uloc_getBaseName(fullName, baseName, ULOC_FULLNAME_CAPACITY, &status);
+        if(baseNameSize >= ULOC_FULLNAME_CAPACITY) {
+            ((Locale *)this)->baseName = (char *)uprv_malloc(sizeof(char) * baseNameSize + 1);
+            uloc_getBaseName(fullName, baseName, baseNameSize+1, &status);
+        }
+        baseName[baseNameSize] = 0;
+    }
+    return baseName;
+}
+
+
 //eof
 U_NAMESPACE_END