b13c951348
Cleaned up all of the MSVC W3 warnings and most of the W4 warnings in the common and i18n projects.
749 lines
29 KiB
C++
749 lines
29 KiB
C++
// © 2016 and later: Unicode, Inc. and others.
|
|
// License & terms of use: http://www.unicode.org/copyright.html
|
|
/*
|
|
*******************************************************************************
|
|
* Copyright (C) 2014-2016, International Business Machines Corporation and
|
|
* others. All Rights Reserved.
|
|
*******************************************************************************
|
|
*
|
|
*
|
|
* File REGION.CPP
|
|
*
|
|
* Modification History:*
|
|
* Date Name Description
|
|
* 01/15/13 Emmons Original Port from ICU4J
|
|
********************************************************************************
|
|
*/
|
|
|
|
/**
|
|
* \file
|
|
* \brief C++ API: Region classes (territory containment)
|
|
*/
|
|
|
|
#include "unicode/region.h"
|
|
#include "unicode/utypes.h"
|
|
#include "unicode/uobject.h"
|
|
#include "unicode/unistr.h"
|
|
#include "unicode/ures.h"
|
|
#include "unicode/decimfmt.h"
|
|
#include "ucln_in.h"
|
|
#include "cstring.h"
|
|
#include "mutex.h"
|
|
#include "uhash.h"
|
|
#include "umutex.h"
|
|
#include "uresimp.h"
|
|
#include "region_impl.h"
|
|
|
|
#if !UCONFIG_NO_FORMATTING
|
|
|
|
|
|
U_CDECL_BEGIN
|
|
|
|
static void U_CALLCONV
|
|
deleteRegion(void *obj) {
|
|
delete (icu::Region *)obj;
|
|
}
|
|
|
|
/**
|
|
* Cleanup callback func
|
|
*/
|
|
static UBool U_CALLCONV region_cleanup(void)
|
|
{
|
|
icu::Region::cleanupRegionData();
|
|
|
|
return TRUE;
|
|
}
|
|
|
|
U_CDECL_END
|
|
|
|
U_NAMESPACE_BEGIN
|
|
|
|
static UInitOnce gRegionDataInitOnce = U_INITONCE_INITIALIZER;
|
|
static UVector* availableRegions[URGN_LIMIT];
|
|
|
|
static UHashtable *regionAliases = NULL;
|
|
static UHashtable *regionIDMap = NULL;
|
|
static UHashtable *numericCodeMap = NULL;
|
|
static UVector *allRegions = NULL;
|
|
|
|
static const UChar UNKNOWN_REGION_ID [] = { 0x5A, 0x5A, 0 }; /* "ZZ" */
|
|
static const UChar OUTLYING_OCEANIA_REGION_ID [] = { 0x51, 0x4F, 0 }; /* "QO" */
|
|
static const UChar WORLD_ID [] = { 0x30, 0x30, 0x31, 0 }; /* "001" */
|
|
static const UChar RANGE_MARKER = 0x7E; /* '~' */
|
|
|
|
UOBJECT_DEFINE_RTTI_IMPLEMENTATION(RegionNameEnumeration)
|
|
|
|
/*
|
|
* Initializes the region data from the ICU resource bundles. The region data
|
|
* contains the basic relationships such as which regions are known, what the numeric
|
|
* codes are, any known aliases, and the territory containment data.
|
|
*
|
|
* If the region data has already loaded, then this method simply returns without doing
|
|
* anything meaningful.
|
|
*/
|
|
void U_CALLCONV Region::loadRegionData(UErrorCode &status) {
|
|
|
|
// Construct service objs first
|
|
LocalUHashtablePointer newRegionIDMap(uhash_open(uhash_hashUnicodeString, uhash_compareUnicodeString, NULL, &status));
|
|
LocalUHashtablePointer newNumericCodeMap(uhash_open(uhash_hashLong,uhash_compareLong,NULL,&status));
|
|
LocalUHashtablePointer newRegionAliases(uhash_open(uhash_hashUnicodeString,uhash_compareUnicodeString,NULL,&status));
|
|
LocalPointer<DecimalFormat> df(new DecimalFormat(status), status);
|
|
|
|
LocalPointer<UVector> continents(new UVector(uprv_deleteUObject, uhash_compareUnicodeString, status), status);
|
|
LocalPointer<UVector> groupings(new UVector(uprv_deleteUObject, uhash_compareUnicodeString, status), status);
|
|
allRegions = new UVector(uprv_deleteUObject, uhash_compareUnicodeString, status);
|
|
|
|
LocalUResourceBundlePointer metadata(ures_openDirect(NULL,"metadata",&status));
|
|
LocalUResourceBundlePointer metadataAlias(ures_getByKey(metadata.getAlias(),"alias",NULL,&status));
|
|
LocalUResourceBundlePointer territoryAlias(ures_getByKey(metadataAlias.getAlias(),"territory",NULL,&status));
|
|
|
|
LocalUResourceBundlePointer supplementalData(ures_openDirect(NULL,"supplementalData",&status));
|
|
LocalUResourceBundlePointer codeMappings(ures_getByKey(supplementalData.getAlias(),"codeMappings",NULL,&status));
|
|
|
|
LocalUResourceBundlePointer idValidity(ures_getByKey(supplementalData.getAlias(),"idValidity",NULL,&status));
|
|
LocalUResourceBundlePointer regionList(ures_getByKey(idValidity.getAlias(),"region",NULL,&status));
|
|
LocalUResourceBundlePointer regionRegular(ures_getByKey(regionList.getAlias(),"regular",NULL,&status));
|
|
LocalUResourceBundlePointer regionMacro(ures_getByKey(regionList.getAlias(),"macroregion",NULL,&status));
|
|
LocalUResourceBundlePointer regionUnknown(ures_getByKey(regionList.getAlias(),"unknown",NULL,&status));
|
|
|
|
LocalUResourceBundlePointer territoryContainment(ures_getByKey(supplementalData.getAlias(),"territoryContainment",NULL,&status));
|
|
LocalUResourceBundlePointer worldContainment(ures_getByKey(territoryContainment.getAlias(),"001",NULL,&status));
|
|
LocalUResourceBundlePointer groupingContainment(ures_getByKey(territoryContainment.getAlias(),"grouping",NULL,&status));
|
|
|
|
if (U_FAILURE(status)) {
|
|
return;
|
|
}
|
|
|
|
// now, initialize
|
|
df->setParseIntegerOnly(TRUE);
|
|
uhash_setValueDeleter(newRegionIDMap.getAlias(), deleteRegion); // regionIDMap owns objs
|
|
uhash_setKeyDeleter(newRegionAliases.getAlias(), uprv_deleteUObject); // regionAliases owns the string keys
|
|
|
|
|
|
while ( ures_hasNext(regionRegular.getAlias()) ) {
|
|
UnicodeString regionName = ures_getNextUnicodeString(regionRegular.getAlias(),NULL,&status);
|
|
int32_t rangeMarkerLocation = regionName.indexOf(RANGE_MARKER);
|
|
UChar buf[6];
|
|
regionName.extract(buf,6,status);
|
|
if ( rangeMarkerLocation > 0 ) {
|
|
UChar endRange = regionName.charAt(rangeMarkerLocation+1);
|
|
buf[rangeMarkerLocation] = 0;
|
|
while ( buf[rangeMarkerLocation-1] <= endRange ) {
|
|
LocalPointer<UnicodeString> newRegion(new UnicodeString(buf), status);
|
|
allRegions->addElement(newRegion.orphan(),status);
|
|
buf[rangeMarkerLocation-1]++;
|
|
}
|
|
} else {
|
|
LocalPointer<UnicodeString> newRegion(new UnicodeString(regionName), status);
|
|
allRegions->addElement(newRegion.orphan(),status);
|
|
}
|
|
}
|
|
|
|
while ( ures_hasNext(regionMacro.getAlias()) ) {
|
|
UnicodeString regionName = ures_getNextUnicodeString(regionMacro.getAlias(),NULL,&status);
|
|
int32_t rangeMarkerLocation = regionName.indexOf(RANGE_MARKER);
|
|
UChar buf[6];
|
|
regionName.extract(buf,6,status);
|
|
if ( rangeMarkerLocation > 0 ) {
|
|
UChar endRange = regionName.charAt(rangeMarkerLocation+1);
|
|
buf[rangeMarkerLocation] = 0;
|
|
while ( buf[rangeMarkerLocation-1] <= endRange ) {
|
|
LocalPointer<UnicodeString> newRegion(new UnicodeString(buf), status);
|
|
allRegions->addElement(newRegion.orphan(),status);
|
|
buf[rangeMarkerLocation-1]++;
|
|
}
|
|
} else {
|
|
LocalPointer<UnicodeString> newRegion(new UnicodeString(regionName), status);
|
|
allRegions->addElement(newRegion.orphan(),status);
|
|
}
|
|
}
|
|
|
|
while ( ures_hasNext(regionUnknown.getAlias()) ) {
|
|
LocalPointer<UnicodeString> regionName (new UnicodeString(ures_getNextUnicodeString(regionUnknown.getAlias(),NULL,&status),status));
|
|
allRegions->addElement(regionName.orphan(),status);
|
|
}
|
|
|
|
while ( ures_hasNext(worldContainment.getAlias()) ) {
|
|
UnicodeString *continentName = new UnicodeString(ures_getNextUnicodeString(worldContainment.getAlias(),NULL,&status));
|
|
continents->addElement(continentName,status);
|
|
}
|
|
|
|
while ( ures_hasNext(groupingContainment.getAlias()) ) {
|
|
UnicodeString *groupingName = new UnicodeString(ures_getNextUnicodeString(groupingContainment.getAlias(),NULL,&status));
|
|
groupings->addElement(groupingName,status);
|
|
}
|
|
|
|
for ( int32_t i = 0 ; i < allRegions->size() ; i++ ) {
|
|
LocalPointer<Region> r(new Region(), status);
|
|
if ( U_FAILURE(status) ) {
|
|
return;
|
|
}
|
|
UnicodeString *regionName = (UnicodeString *)allRegions->elementAt(i);
|
|
r->idStr = *regionName;
|
|
|
|
r->idStr.extract(0,r->idStr.length(),r->id,sizeof(r->id),US_INV);
|
|
r->fType = URGN_TERRITORY; // Only temporary - figure out the real type later once the aliases are known.
|
|
|
|
Formattable result;
|
|
UErrorCode ps = U_ZERO_ERROR;
|
|
df->parse(r->idStr,result,ps);
|
|
if ( U_SUCCESS(ps) ) {
|
|
r->code = result.getLong(); // Convert string to number
|
|
uhash_iput(newNumericCodeMap.getAlias(),r->code,(void *)(r.getAlias()),&status);
|
|
r->fType = URGN_SUBCONTINENT;
|
|
} else {
|
|
r->code = -1;
|
|
}
|
|
void* idStrAlias = (void*)&(r->idStr); // about to orphan 'r'. Save this off.
|
|
uhash_put(newRegionIDMap.getAlias(),idStrAlias,(void *)(r.orphan()),&status); // regionIDMap takes ownership
|
|
}
|
|
|
|
// Process the territory aliases
|
|
while ( ures_hasNext(territoryAlias.getAlias()) ) {
|
|
LocalUResourceBundlePointer res(ures_getNextResource(territoryAlias.getAlias(),NULL,&status));
|
|
const char *aliasFrom = ures_getKey(res.getAlias());
|
|
LocalPointer<UnicodeString> aliasFromStr(new UnicodeString(aliasFrom, -1, US_INV), status);
|
|
UnicodeString aliasTo = ures_getUnicodeStringByKey(res.getAlias(),"replacement",&status);
|
|
res.adoptInstead(NULL);
|
|
|
|
const Region *aliasToRegion = (Region *) uhash_get(newRegionIDMap.getAlias(),&aliasTo);
|
|
Region *aliasFromRegion = (Region *)uhash_get(newRegionIDMap.getAlias(),aliasFromStr.getAlias());
|
|
|
|
if ( aliasToRegion != NULL && aliasFromRegion == NULL ) { // This is just an alias from some string to a region
|
|
uhash_put(newRegionAliases.getAlias(),(void *)aliasFromStr.orphan(), (void *)aliasToRegion,&status);
|
|
} else {
|
|
if ( aliasFromRegion == NULL ) { // Deprecated region code not in the master codes list - so need to create a deprecated region for it.
|
|
LocalPointer<Region> newRgn(new Region, status);
|
|
if ( U_SUCCESS(status) ) {
|
|
aliasFromRegion = newRgn.orphan();
|
|
} else {
|
|
return; // error out
|
|
}
|
|
aliasFromRegion->idStr.setTo(*aliasFromStr);
|
|
aliasFromRegion->idStr.extract(0,aliasFromRegion->idStr.length(),aliasFromRegion->id,sizeof(aliasFromRegion->id),US_INV);
|
|
uhash_put(newRegionIDMap.getAlias(),(void *)&(aliasFromRegion->idStr),(void *)aliasFromRegion,&status);
|
|
Formattable result;
|
|
UErrorCode ps = U_ZERO_ERROR;
|
|
df->parse(aliasFromRegion->idStr,result,ps);
|
|
if ( U_SUCCESS(ps) ) {
|
|
aliasFromRegion->code = result.getLong(); // Convert string to number
|
|
uhash_iput(newNumericCodeMap.getAlias(),aliasFromRegion->code,(void *)aliasFromRegion,&status);
|
|
} else {
|
|
aliasFromRegion->code = -1;
|
|
}
|
|
aliasFromRegion->fType = URGN_DEPRECATED;
|
|
} else {
|
|
aliasFromRegion->fType = URGN_DEPRECATED;
|
|
}
|
|
|
|
{
|
|
LocalPointer<UVector> newPreferredValues(new UVector(uprv_deleteUObject, uhash_compareUnicodeString, status), status);
|
|
aliasFromRegion->preferredValues = newPreferredValues.orphan();
|
|
}
|
|
if( U_FAILURE(status)) {
|
|
return;
|
|
}
|
|
UnicodeString currentRegion;
|
|
//currentRegion.remove(); TODO: was already 0 length?
|
|
for (int32_t i = 0 ; i < aliasTo.length() ; i++ ) {
|
|
if ( aliasTo.charAt(i) != 0x0020 ) {
|
|
currentRegion.append(aliasTo.charAt(i));
|
|
}
|
|
if ( aliasTo.charAt(i) == 0x0020 || i+1 == aliasTo.length() ) {
|
|
Region *target = (Region *)uhash_get(newRegionIDMap.getAlias(),(void *)¤tRegion);
|
|
if (target) {
|
|
LocalPointer<UnicodeString> preferredValue(new UnicodeString(target->idStr), status);
|
|
aliasFromRegion->preferredValues->addElement((void *)preferredValue.orphan(),status); // may add null if err
|
|
}
|
|
currentRegion.remove();
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
// Process the code mappings - This will allow us to assign numeric codes to most of the territories.
|
|
while ( ures_hasNext(codeMappings.getAlias()) ) {
|
|
UResourceBundle *mapping = ures_getNextResource(codeMappings.getAlias(),NULL,&status);
|
|
if ( ures_getType(mapping) == URES_ARRAY && ures_getSize(mapping) == 3) {
|
|
UnicodeString codeMappingID = ures_getUnicodeStringByIndex(mapping,0,&status);
|
|
UnicodeString codeMappingNumber = ures_getUnicodeStringByIndex(mapping,1,&status);
|
|
UnicodeString codeMapping3Letter = ures_getUnicodeStringByIndex(mapping,2,&status);
|
|
|
|
Region *r = (Region *)uhash_get(newRegionIDMap.getAlias(),(void *)&codeMappingID);
|
|
if ( r ) {
|
|
Formattable result;
|
|
UErrorCode ps = U_ZERO_ERROR;
|
|
df->parse(codeMappingNumber,result,ps);
|
|
if ( U_SUCCESS(ps) ) {
|
|
r->code = result.getLong(); // Convert string to number
|
|
uhash_iput(newNumericCodeMap.getAlias(),r->code,(void *)r,&status);
|
|
}
|
|
LocalPointer<UnicodeString> code3(new UnicodeString(codeMapping3Letter), status);
|
|
uhash_put(newRegionAliases.getAlias(),(void *)code3.orphan(), (void *)r,&status);
|
|
}
|
|
}
|
|
ures_close(mapping);
|
|
}
|
|
|
|
// Now fill in the special cases for WORLD, UNKNOWN, CONTINENTS, and GROUPINGS
|
|
Region *r;
|
|
UnicodeString WORLD_ID_STRING(WORLD_ID);
|
|
r = (Region *) uhash_get(newRegionIDMap.getAlias(),(void *)&WORLD_ID_STRING);
|
|
if ( r ) {
|
|
r->fType = URGN_WORLD;
|
|
}
|
|
|
|
UnicodeString UNKNOWN_REGION_ID_STRING(UNKNOWN_REGION_ID);
|
|
r = (Region *) uhash_get(newRegionIDMap.getAlias(),(void *)&UNKNOWN_REGION_ID_STRING);
|
|
if ( r ) {
|
|
r->fType = URGN_UNKNOWN;
|
|
}
|
|
|
|
for ( int32_t i = 0 ; i < continents->size() ; i++ ) {
|
|
r = (Region *) uhash_get(newRegionIDMap.getAlias(),(void *)continents->elementAt(i));
|
|
if ( r ) {
|
|
r->fType = URGN_CONTINENT;
|
|
}
|
|
}
|
|
|
|
for ( int32_t i = 0 ; i < groupings->size() ; i++ ) {
|
|
r = (Region *) uhash_get(newRegionIDMap.getAlias(),(void *)groupings->elementAt(i));
|
|
if ( r ) {
|
|
r->fType = URGN_GROUPING;
|
|
}
|
|
}
|
|
|
|
// Special case: The region code "QO" (Outlying Oceania) is a subcontinent code added by CLDR
|
|
// even though it looks like a territory code. Need to handle it here.
|
|
|
|
UnicodeString OUTLYING_OCEANIA_REGION_ID_STRING(OUTLYING_OCEANIA_REGION_ID);
|
|
r = (Region *) uhash_get(newRegionIDMap.getAlias(),(void *)&OUTLYING_OCEANIA_REGION_ID_STRING);
|
|
if ( r ) {
|
|
r->fType = URGN_SUBCONTINENT;
|
|
}
|
|
|
|
// Load territory containment info from the supplemental data.
|
|
while ( ures_hasNext(territoryContainment.getAlias()) ) {
|
|
LocalUResourceBundlePointer mapping(ures_getNextResource(territoryContainment.getAlias(),NULL,&status));
|
|
if( U_FAILURE(status) ) {
|
|
return; // error out
|
|
}
|
|
const char *parent = ures_getKey(mapping.getAlias());
|
|
if (uprv_strcmp(parent, "containedGroupings") == 0 || uprv_strcmp(parent, "deprecated") == 0) {
|
|
continue; // handle new pseudo-parent types added in ICU data per cldrbug 7808; for now just skip.
|
|
// #11232 is to do something useful with these.
|
|
}
|
|
UnicodeString parentStr = UnicodeString(parent, -1 , US_INV);
|
|
Region *parentRegion = (Region *) uhash_get(newRegionIDMap.getAlias(),(void *)&parentStr);
|
|
|
|
for ( int j = 0 ; j < ures_getSize(mapping.getAlias()); j++ ) {
|
|
UnicodeString child = ures_getUnicodeStringByIndex(mapping.getAlias(),j,&status);
|
|
Region *childRegion = (Region *) uhash_get(newRegionIDMap.getAlias(),(void *)&child);
|
|
if ( parentRegion != NULL && childRegion != NULL ) {
|
|
|
|
// Add the child region to the set of regions contained by the parent
|
|
if (parentRegion->containedRegions == NULL) {
|
|
parentRegion->containedRegions = new UVector(uprv_deleteUObject, uhash_compareUnicodeString, status);
|
|
}
|
|
|
|
LocalPointer<UnicodeString> childStr(new UnicodeString(), status);
|
|
if( U_FAILURE(status) ) {
|
|
return; // error out
|
|
}
|
|
childStr->fastCopyFrom(childRegion->idStr);
|
|
parentRegion->containedRegions->addElement((void *)childStr.orphan(),status);
|
|
|
|
// Set the parent region to be the containing region of the child.
|
|
// Regions of type GROUPING can't be set as the parent, since another region
|
|
// such as a SUBCONTINENT, CONTINENT, or WORLD must always be the parent.
|
|
if ( parentRegion->fType != URGN_GROUPING) {
|
|
childRegion->containingRegion = parentRegion;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
// Create the availableRegions lists
|
|
int32_t pos = UHASH_FIRST;
|
|
while ( const UHashElement* element = uhash_nextElement(newRegionIDMap.getAlias(),&pos)) {
|
|
Region *ar = (Region *)element->value.pointer;
|
|
if ( availableRegions[ar->fType] == NULL ) {
|
|
LocalPointer<UVector> newAr(new UVector(uprv_deleteUObject, uhash_compareUnicodeString, status), status);
|
|
availableRegions[ar->fType] = newAr.orphan();
|
|
}
|
|
LocalPointer<UnicodeString> arString(new UnicodeString(ar->idStr), status);
|
|
if( U_FAILURE(status) ) {
|
|
return; // error out
|
|
}
|
|
availableRegions[ar->fType]->addElement((void *)arString.orphan(),status);
|
|
}
|
|
|
|
ucln_i18n_registerCleanup(UCLN_I18N_REGION, region_cleanup);
|
|
// copy hashtables
|
|
numericCodeMap = newNumericCodeMap.orphan();
|
|
regionIDMap = newRegionIDMap.orphan();
|
|
regionAliases = newRegionAliases.orphan();
|
|
}
|
|
|
|
void Region::cleanupRegionData() {
|
|
for (int32_t i = 0 ; i < URGN_LIMIT ; i++ ) {
|
|
if ( availableRegions[i] ) {
|
|
delete availableRegions[i];
|
|
}
|
|
}
|
|
|
|
if (regionAliases) {
|
|
uhash_close(regionAliases);
|
|
}
|
|
|
|
if (numericCodeMap) {
|
|
uhash_close(numericCodeMap);
|
|
}
|
|
|
|
if (regionIDMap) {
|
|
uhash_close(regionIDMap);
|
|
}
|
|
if (allRegions) {
|
|
allRegions->removeAllElements(); // Don't need the temporary list anymore.
|
|
delete allRegions;
|
|
allRegions = NULL;
|
|
}
|
|
|
|
regionAliases = numericCodeMap = regionIDMap = NULL;
|
|
|
|
gRegionDataInitOnce.reset();
|
|
}
|
|
|
|
Region::Region ()
|
|
: code(-1),
|
|
fType(URGN_UNKNOWN),
|
|
containingRegion(NULL),
|
|
containedRegions(NULL),
|
|
preferredValues(NULL) {
|
|
id[0] = 0;
|
|
}
|
|
|
|
Region::~Region () {
|
|
if (containedRegions) {
|
|
delete containedRegions;
|
|
}
|
|
if (preferredValues) {
|
|
delete preferredValues;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Returns true if the two regions are equal.
|
|
* Per PMC, just use pointer compare, since we have at most one instance of each Region.
|
|
*/
|
|
UBool
|
|
Region::operator==(const Region &that) const {
|
|
return (idStr == that.idStr);
|
|
}
|
|
|
|
/**
|
|
* Returns true if the two regions are NOT equal; that is, if operator ==() returns false.
|
|
* Per PMC, just use pointer compare, since we have at most one instance of each Region.
|
|
*/
|
|
UBool
|
|
Region::operator!=(const Region &that) const {
|
|
return (idStr != that.idStr);
|
|
}
|
|
|
|
/**
|
|
* Returns a pointer to a Region using the given region code. The region code can be either 2-letter ISO code,
|
|
* 3-letter ISO code, UNM.49 numeric code, or other valid Unicode Region Code as defined by the LDML specification.
|
|
* The identifier will be canonicalized internally using the supplemental metadata as defined in the CLDR.
|
|
* If the region code is NULL or not recognized, the appropriate error code will be set ( U_ILLEGAL_ARGUMENT_ERROR )
|
|
*/
|
|
const Region* U_EXPORT2
|
|
Region::getInstance(const char *region_code, UErrorCode &status) {
|
|
|
|
umtx_initOnce(gRegionDataInitOnce, &loadRegionData, status);
|
|
if (U_FAILURE(status)) {
|
|
return NULL;
|
|
}
|
|
|
|
if ( !region_code ) {
|
|
status = U_ILLEGAL_ARGUMENT_ERROR;
|
|
return NULL;
|
|
}
|
|
|
|
UnicodeString regionCodeString = UnicodeString(region_code, -1, US_INV);
|
|
Region *r = (Region *)uhash_get(regionIDMap,(void *)®ionCodeString);
|
|
|
|
if ( !r ) {
|
|
r = (Region *)uhash_get(regionAliases,(void *)®ionCodeString);
|
|
}
|
|
|
|
if ( !r ) { // Unknown region code
|
|
status = U_ILLEGAL_ARGUMENT_ERROR;
|
|
return NULL;
|
|
}
|
|
|
|
if ( r->fType == URGN_DEPRECATED && r->preferredValues->size() == 1) {
|
|
StringEnumeration *pv = r->getPreferredValues(status);
|
|
pv->reset(status);
|
|
const UnicodeString *ustr = pv->snext(status);
|
|
r = (Region *)uhash_get(regionIDMap,(void *)ustr);
|
|
delete pv;
|
|
}
|
|
|
|
return r;
|
|
|
|
}
|
|
|
|
/**
|
|
* Returns a pointer to a Region using the given numeric region code. If the numeric region code is not recognized,
|
|
* the appropriate error code will be set ( U_ILLEGAL_ARGUMENT_ERROR ).
|
|
*/
|
|
const Region* U_EXPORT2
|
|
Region::getInstance (int32_t code, UErrorCode &status) {
|
|
|
|
umtx_initOnce(gRegionDataInitOnce, &loadRegionData, status);
|
|
if (U_FAILURE(status)) {
|
|
return NULL;
|
|
}
|
|
|
|
Region *r = (Region *)uhash_iget(numericCodeMap,code);
|
|
|
|
if ( !r ) { // Just in case there's an alias that's numeric, try to find it.
|
|
UnicodeString pat = UNICODE_STRING_SIMPLE("0");
|
|
LocalPointer<DecimalFormat> df(new DecimalFormat(pat,status), status);
|
|
if( U_FAILURE(status) ) {
|
|
return NULL;
|
|
}
|
|
UnicodeString id;
|
|
id.remove();
|
|
FieldPosition posIter;
|
|
df->format(code,id, posIter, status);
|
|
r = (Region *)uhash_get(regionAliases,&id);
|
|
}
|
|
|
|
if( U_FAILURE(status) ) {
|
|
return NULL;
|
|
}
|
|
|
|
if ( !r ) {
|
|
status = U_ILLEGAL_ARGUMENT_ERROR;
|
|
return NULL;
|
|
}
|
|
|
|
if ( r->fType == URGN_DEPRECATED && r->preferredValues->size() == 1) {
|
|
StringEnumeration *pv = r->getPreferredValues(status);
|
|
pv->reset(status);
|
|
const UnicodeString *ustr = pv->snext(status);
|
|
r = (Region *)uhash_get(regionIDMap,(void *)ustr);
|
|
delete pv;
|
|
}
|
|
|
|
return r;
|
|
}
|
|
|
|
|
|
/**
|
|
* Returns an enumeration over the IDs of all known regions that match the given type.
|
|
*/
|
|
StringEnumeration* U_EXPORT2
|
|
Region::getAvailable(URegionType type, UErrorCode &status) {
|
|
umtx_initOnce(gRegionDataInitOnce, &loadRegionData, status); // returns immediately if U_FAILURE(status)
|
|
if (U_FAILURE(status)) {
|
|
return NULL;
|
|
}
|
|
return new RegionNameEnumeration(availableRegions[type],status);
|
|
}
|
|
|
|
/**
|
|
* Returns a pointer to the region that contains this region. Returns NULL if this region is code "001" (World)
|
|
* or "ZZ" (Unknown region). For example, calling this method with region "IT" (Italy) returns the
|
|
* region "039" (Southern Europe).
|
|
*/
|
|
const Region*
|
|
Region::getContainingRegion() const {
|
|
UErrorCode status = U_ZERO_ERROR;
|
|
umtx_initOnce(gRegionDataInitOnce, &loadRegionData, status);
|
|
return containingRegion;
|
|
}
|
|
|
|
/**
|
|
* Return a pointer to the region that geographically contains this region and matches the given type,
|
|
* moving multiple steps up the containment chain if necessary. Returns NULL if no containing region can be found
|
|
* that matches the given type. Note: The URegionTypes = "URGN_GROUPING", "URGN_DEPRECATED", or "URGN_UNKNOWN"
|
|
* are not appropriate for use in this API. NULL will be returned in this case. For example, calling this method
|
|
* with region "IT" (Italy) for type "URGN_CONTINENT" returns the region "150" ( Europe ).
|
|
*/
|
|
const Region*
|
|
Region::getContainingRegion(URegionType type) const {
|
|
UErrorCode status = U_ZERO_ERROR;
|
|
umtx_initOnce(gRegionDataInitOnce, &loadRegionData, status);
|
|
if ( containingRegion == NULL ) {
|
|
return NULL;
|
|
}
|
|
|
|
return ( containingRegion->fType == type)? containingRegion: containingRegion->getContainingRegion(type);
|
|
}
|
|
|
|
/**
|
|
* Return an enumeration over the IDs of all the regions that are immediate children of this region in the
|
|
* region hierarchy. These returned regions could be either macro regions, territories, or a mixture of the two,
|
|
* depending on the containment data as defined in CLDR. This API may return NULL if this region doesn't have
|
|
* any sub-regions. For example, calling this method with region "150" (Europe) returns an enumeration containing
|
|
* the various sub regions of Europe - "039" (Southern Europe) - "151" (Eastern Europe) - "154" (Northern Europe)
|
|
* and "155" (Western Europe).
|
|
*/
|
|
StringEnumeration*
|
|
Region::getContainedRegions(UErrorCode &status) const {
|
|
umtx_initOnce(gRegionDataInitOnce, &loadRegionData, status); // returns immediately if U_FAILURE(status)
|
|
if (U_FAILURE(status)) {
|
|
return NULL;
|
|
}
|
|
return new RegionNameEnumeration(containedRegions,status);
|
|
}
|
|
|
|
/**
|
|
* Returns an enumeration over the IDs of all the regions that are children of this region anywhere in the region
|
|
* hierarchy and match the given type. This API may return an empty enumeration if this region doesn't have any
|
|
* sub-regions that match the given type. For example, calling this method with region "150" (Europe) and type
|
|
* "URGN_TERRITORY" returns a set containing all the territories in Europe ( "FR" (France) - "IT" (Italy) - "DE" (Germany) etc. )
|
|
*/
|
|
StringEnumeration*
|
|
Region::getContainedRegions( URegionType type, UErrorCode &status ) const {
|
|
umtx_initOnce(gRegionDataInitOnce, &loadRegionData, status); // returns immediately if U_FAILURE(status)
|
|
if (U_FAILURE(status)) {
|
|
return NULL;
|
|
}
|
|
|
|
UVector *result = new UVector(NULL, uhash_compareChars, status);
|
|
|
|
StringEnumeration *cr = getContainedRegions(status);
|
|
|
|
for ( int32_t i = 0 ; i < cr->count(status) ; i++ ) {
|
|
const char *regionId = cr->next(NULL,status);
|
|
const Region *r = Region::getInstance(regionId,status);
|
|
if ( r->getType() == type) {
|
|
result->addElement((void *)&r->idStr,status);
|
|
} else {
|
|
StringEnumeration *children = r->getContainedRegions(type, status);
|
|
for ( int32_t j = 0 ; j < children->count(status) ; j++ ) {
|
|
const char *id2 = children->next(NULL,status);
|
|
const Region *r2 = Region::getInstance(id2,status);
|
|
result->addElement((void *)&r2->idStr,status);
|
|
}
|
|
delete children;
|
|
}
|
|
}
|
|
delete cr;
|
|
StringEnumeration* resultEnumeration = new RegionNameEnumeration(result,status);
|
|
delete result;
|
|
return resultEnumeration;
|
|
}
|
|
|
|
/**
|
|
* Returns true if this region contains the supplied other region anywhere in the region hierarchy.
|
|
*/
|
|
UBool
|
|
Region::contains(const Region &other) const {
|
|
UErrorCode status = U_ZERO_ERROR;
|
|
umtx_initOnce(gRegionDataInitOnce, &loadRegionData, status);
|
|
|
|
if (!containedRegions) {
|
|
return FALSE;
|
|
}
|
|
if (containedRegions->contains((void *)&other.idStr)) {
|
|
return TRUE;
|
|
} else {
|
|
for ( int32_t i = 0 ; i < containedRegions->size() ; i++ ) {
|
|
UnicodeString *crStr = (UnicodeString *)containedRegions->elementAt(i);
|
|
Region *cr = (Region *) uhash_get(regionIDMap,(void *)crStr);
|
|
if ( cr && cr->contains(other) ) {
|
|
return TRUE;
|
|
}
|
|
}
|
|
}
|
|
|
|
return FALSE;
|
|
}
|
|
|
|
/**
|
|
* For deprecated regions, return an enumeration over the IDs of the regions that are the preferred replacement
|
|
* regions for this region. Returns NULL for a non-deprecated region. For example, calling this method with region
|
|
* "SU" (Soviet Union) would return a list of the regions containing "RU" (Russia), "AM" (Armenia), "AZ" (Azerbaijan), etc...
|
|
*/
|
|
StringEnumeration*
|
|
Region::getPreferredValues(UErrorCode &status) const {
|
|
umtx_initOnce(gRegionDataInitOnce, &loadRegionData, status); // returns immediately if U_FAILURE(status)
|
|
if (U_FAILURE(status) || fType != URGN_DEPRECATED) {
|
|
return NULL;
|
|
}
|
|
return new RegionNameEnumeration(preferredValues,status);
|
|
}
|
|
|
|
|
|
/**
|
|
* Return this region's canonical region code.
|
|
*/
|
|
const char*
|
|
Region::getRegionCode() const {
|
|
return id;
|
|
}
|
|
|
|
int32_t
|
|
Region::getNumericCode() const {
|
|
return code;
|
|
}
|
|
|
|
/**
|
|
* Returns the region type of this region.
|
|
*/
|
|
URegionType
|
|
Region::getType() const {
|
|
return fType;
|
|
}
|
|
|
|
RegionNameEnumeration::RegionNameEnumeration(UVector *fNameList, UErrorCode& status) {
|
|
pos=0;
|
|
if (fNameList && U_SUCCESS(status)) {
|
|
fRegionNames = new UVector(uprv_deleteUObject, uhash_compareUnicodeString, fNameList->size(),status);
|
|
for ( int32_t i = 0 ; i < fNameList->size() ; i++ ) {
|
|
UnicodeString* this_region_name = (UnicodeString *)fNameList->elementAt(i);
|
|
UnicodeString* new_region_name = new UnicodeString(*this_region_name);
|
|
fRegionNames->addElement((void *)new_region_name,status);
|
|
}
|
|
}
|
|
else {
|
|
fRegionNames = NULL;
|
|
}
|
|
}
|
|
|
|
const UnicodeString*
|
|
RegionNameEnumeration::snext(UErrorCode& status) {
|
|
if (U_FAILURE(status) || (fRegionNames==NULL)) {
|
|
return NULL;
|
|
}
|
|
const UnicodeString* nextStr = (const UnicodeString *)fRegionNames->elementAt(pos);
|
|
if (nextStr!=NULL) {
|
|
pos++;
|
|
}
|
|
return nextStr;
|
|
}
|
|
|
|
void
|
|
RegionNameEnumeration::reset(UErrorCode& /*status*/) {
|
|
pos=0;
|
|
}
|
|
|
|
int32_t
|
|
RegionNameEnumeration::count(UErrorCode& /*status*/) const {
|
|
return (fRegionNames==NULL) ? 0 : fRegionNames->size();
|
|
}
|
|
|
|
RegionNameEnumeration::~RegionNameEnumeration() {
|
|
delete fRegionNames;
|
|
}
|
|
|
|
U_NAMESPACE_END
|
|
|
|
#endif /* #if !UCONFIG_NO_FORMATTING */
|
|
|
|
//eof
|