region.h

Go to the documentation of this file.

// © 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.
 *******************************************************************************
 */

#ifndef REGION_H
#define REGION_H

#include "unicode/utypes.h"
#include "unicode/uregion.h"

#if !UCONFIG_NO_FORMATTING

#include "unicode/uobject.h"
#include "unicode/uniset.h"
#include "unicode/unistr.h"
#include "unicode/strenum.h"

U_NAMESPACE_BEGIN

class U_I18N_API Region : public UObject {
public:
    virtual ~Region();

    UBool operator==(const Region &that) const;

    UBool operator!=(const Region &that) const;
 
    static const Region* U_EXPORT2 getInstance(const char *region_code, UErrorCode &status);

    static const Region* U_EXPORT2 getInstance (int32_t code, UErrorCode &status);

    static StringEnumeration* U_EXPORT2 getAvailable(URegionType type, UErrorCode &status);
   
    const Region* getContainingRegion() const;

    const Region* getContainingRegion(URegionType type) const;

    StringEnumeration* getContainedRegions(UErrorCode &status) const;

    StringEnumeration* getContainedRegions( URegionType type, UErrorCode &status ) const;
 
    UBool contains(const Region &other) const;

    StringEnumeration* getPreferredValues(UErrorCode &status) const;

    const char* getRegionCode() const;

    int32_t getNumericCode() const;

    URegionType getType() const;

#ifndef U_HIDE_INTERNAL_API

    static void cleanupRegionData();
#endif  /* U_HIDE_INTERNAL_API */

private:
    char id[4];
    UnicodeString idStr;
    int32_t code;
    URegionType fType;
    Region *containingRegion;
    UVector *containedRegions;
    UVector *preferredValues;

    Region();


    /*
     * 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.
     */

    static void U_CALLCONV loadRegionData(UErrorCode &status);

};

U_NAMESPACE_END

#endif /* #if !UCONFIG_NO_FORMATTING */
#endif // REGION_H

//eof