2009-06-16 05:56:50 +00:00
|
|
|
/*
|
|
|
|
*******************************************************************************
|
2010-01-23 06:36:03 +00:00
|
|
|
* Copyright (C) 2010, International Business Machines Corporation and
|
2009-06-16 05:56:50 +00:00
|
|
|
* others. All Rights Reserved.
|
|
|
|
*******************************************************************************
|
|
|
|
*
|
|
|
|
*
|
|
|
|
* File NUMSYS.H
|
|
|
|
*
|
|
|
|
* Modification History:*
|
|
|
|
* Date Name Description
|
|
|
|
*
|
|
|
|
********************************************************************************
|
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef NUMSYS
|
|
|
|
#define NUMSYS
|
2010-06-23 03:13:59 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* \def NUMSYS_NAME_CAPACITY
|
|
|
|
* Size of a numbering system name.
|
|
|
|
* @internal
|
|
|
|
*/
|
2010-06-04 18:29:02 +00:00
|
|
|
#define NUMSYS_NAME_CAPACITY 8
|
2010-06-23 03:13:59 +00:00
|
|
|
|
2009-06-16 05:56:50 +00:00
|
|
|
#include "unicode/utypes.h"
|
|
|
|
|
|
|
|
/**
|
|
|
|
* \file
|
|
|
|
* \brief C++ API: NumberingSystem object
|
|
|
|
*/
|
|
|
|
|
|
|
|
#if !UCONFIG_NO_FORMATTING
|
|
|
|
|
|
|
|
|
|
|
|
#include "unicode/format.h"
|
|
|
|
#include "unicode/uobject.h"
|
|
|
|
|
|
|
|
U_NAMESPACE_BEGIN
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Defines numbering systems. A numbering system describes the scheme by which
|
|
|
|
* numbers are to be presented to the end user. In its simplest form, a numbering
|
|
|
|
* system describes the set of digit characters that are to be used to display
|
|
|
|
* numbers, such as Western digits, Thai digits, Arabic-Indic digits, etc.
|
|
|
|
* More complicated numbering systems are algorithmic in nature, and require use
|
|
|
|
* of an RBNF formatter ( rule based number formatter ), in order to calculate
|
|
|
|
* the characters to be displayed for a given number. Examples of algorithmic
|
|
|
|
* numbering systems include Roman numerals, Chinese numerals, and Hebrew numerals.
|
|
|
|
* Formatting rules for many commonly used numbering systems are included in
|
|
|
|
* the ICU package, based on the numbering system rules defined in CLDR.
|
|
|
|
* Alternate numbering systems can be specified to a locale by using the
|
|
|
|
* numbers locale keyword.
|
|
|
|
*/
|
|
|
|
|
|
|
|
class U_I18N_API NumberingSystem : public UObject {
|
|
|
|
public:
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Default Constructor.
|
|
|
|
*
|
2010-01-28 21:09:53 +00:00
|
|
|
* @stable ICU 4.2
|
2009-06-16 05:56:50 +00:00
|
|
|
*/
|
|
|
|
NumberingSystem();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Copy constructor.
|
2010-01-28 21:09:53 +00:00
|
|
|
* @stable ICU 4.2
|
2009-06-16 05:56:50 +00:00
|
|
|
*/
|
|
|
|
NumberingSystem(const NumberingSystem& other);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Destructor.
|
2010-01-28 21:09:53 +00:00
|
|
|
* @stable ICU 4.2
|
2009-06-16 05:56:50 +00:00
|
|
|
*/
|
|
|
|
virtual ~NumberingSystem();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Create the default numbering system associated with the specified locale.
|
|
|
|
* @param inLocale The given locale.
|
|
|
|
* @param status ICU status
|
2010-01-28 21:09:53 +00:00
|
|
|
* @stable ICU 4.2
|
2009-06-16 05:56:50 +00:00
|
|
|
*/
|
|
|
|
static NumberingSystem* U_EXPORT2 createInstance(const Locale & inLocale, UErrorCode& status);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Create the default numbering system associated with the default locale.
|
2010-01-28 21:09:53 +00:00
|
|
|
* @stable ICU 4.2
|
2009-06-16 05:56:50 +00:00
|
|
|
*/
|
|
|
|
static NumberingSystem* U_EXPORT2 createInstance(UErrorCode& status);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Create a numbering system using the specified radix, type, and description.
|
|
|
|
* @param radix The radix (base) for this numbering system.
|
|
|
|
* @param isAlgorithmic TRUE if the numbering system is algorithmic rather than numeric.
|
|
|
|
* @param description The string representing the set of digits used in a numeric system, or the name of the RBNF
|
|
|
|
* ruleset to be used in an algorithmic system.
|
|
|
|
* @param status ICU status
|
2010-01-28 21:09:53 +00:00
|
|
|
* @stable ICU 4.2
|
2009-06-16 05:56:50 +00:00
|
|
|
*/
|
|
|
|
static NumberingSystem* U_EXPORT2 createInstance(int32_t radix, UBool isAlgorithmic, const UnicodeString& description, UErrorCode& status );
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Return a StringEnumeration over all the names of numbering systems known to ICU.
|
2010-01-28 21:09:53 +00:00
|
|
|
* @stable ICU 4.2
|
2009-06-16 05:56:50 +00:00
|
|
|
*/
|
|
|
|
|
|
|
|
static StringEnumeration * U_EXPORT2 getAvailableNames(UErrorCode& status);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Create a numbering system from one of the predefined numbering systems known to ICU.
|
|
|
|
* @param name The name of the numbering system.
|
|
|
|
* @param status ICU status
|
2010-01-28 21:09:53 +00:00
|
|
|
* @stable ICU 4.2
|
2009-06-16 05:56:50 +00:00
|
|
|
*/
|
|
|
|
static NumberingSystem* U_EXPORT2 createInstanceByName(const char* name, UErrorCode& status);
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Returns the radix of this numbering system.
|
2010-01-28 21:09:53 +00:00
|
|
|
* @stable ICU 4.2
|
2009-06-16 05:56:50 +00:00
|
|
|
*/
|
|
|
|
int32_t getRadix();
|
|
|
|
|
2010-06-04 18:29:02 +00:00
|
|
|
/**
|
|
|
|
* Returns the name of this numbering system if it was created using one of the predefined names
|
|
|
|
* known to ICU. Otherwise, returns NULL.
|
|
|
|
* @draft ICU 4.6
|
|
|
|
*/
|
|
|
|
const char * getName();
|
|
|
|
|
2009-06-16 05:56:50 +00:00
|
|
|
/**
|
|
|
|
* Returns the description string of this numbering system, which is either
|
|
|
|
* the string of digits in the case of simple systems, or the ruleset name
|
|
|
|
* in the case of algorithmic systems.
|
2010-01-28 21:09:53 +00:00
|
|
|
* @stable ICU 4.2
|
2009-06-16 05:56:50 +00:00
|
|
|
*/
|
|
|
|
virtual UnicodeString getDescription();
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Returns TRUE if the given numbering system is algorithmic
|
|
|
|
*
|
|
|
|
* @return TRUE if the numbering system is algorithmic.
|
|
|
|
* Otherwise, return FALSE.
|
2010-01-28 21:09:53 +00:00
|
|
|
* @stable ICU 4.2
|
2009-06-16 05:56:50 +00:00
|
|
|
*/
|
|
|
|
UBool isAlgorithmic() const;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* ICU "poor man's RTTI", returns a UClassID for this class.
|
|
|
|
*
|
2010-01-28 21:09:53 +00:00
|
|
|
* @stable ICU 4.2
|
2009-06-16 05:56:50 +00:00
|
|
|
*
|
|
|
|
*/
|
|
|
|
static UClassID U_EXPORT2 getStaticClassID(void);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* ICU "poor man's RTTI", returns a UClassID for the actual class.
|
|
|
|
*
|
2010-01-28 21:09:53 +00:00
|
|
|
* @stable ICU 4.2
|
2009-06-16 05:56:50 +00:00
|
|
|
*/
|
|
|
|
virtual UClassID getDynamicClassID() const;
|
|
|
|
|
|
|
|
|
|
|
|
private:
|
|
|
|
UnicodeString desc;
|
|
|
|
int32_t radix;
|
|
|
|
UBool algorithmic;
|
2010-06-04 18:29:02 +00:00
|
|
|
char name[NUMSYS_NAME_CAPACITY+1];
|
2009-06-16 05:56:50 +00:00
|
|
|
|
|
|
|
void setRadix(int32_t radix);
|
|
|
|
|
|
|
|
void setAlgorithmic(UBool algorithmic);
|
|
|
|
|
|
|
|
void setDesc(UnicodeString desc);
|
|
|
|
|
2010-06-04 18:29:02 +00:00
|
|
|
void setName(const char* name);
|
|
|
|
|
2009-06-16 05:56:50 +00:00
|
|
|
static UBool isValidDigitString(const UnicodeString &str);
|
|
|
|
|
|
|
|
UBool hasContiguousDecimalDigits() const;
|
|
|
|
};
|
|
|
|
|
|
|
|
U_NAMESPACE_END
|
|
|
|
|
|
|
|
#endif /* #if !UCONFIG_NO_FORMATTING */
|
|
|
|
|
|
|
|
#endif // _NUMSYS
|
|
|
|
//eof
|