/src/icu/source/i18n/unicode/numsys.h

Source (jump to first uncovered line)
// © 2016 and later: Unicode, Inc. and others.
// License & terms of use: http://www.unicode.org/copyright.html
/*
*******************************************************************************
* Copyright (C) 2010-2014, International Business Machines Corporation and
* others. All Rights Reserved.
*******************************************************************************
*
*
* File NUMSYS.H
*
* Modification History:*
*   Date        Name        Description
*
********************************************************************************
*/

#ifndef NUMSYS
#define NUMSYS

#include "unicode/utypes.h"

#if U_SHOW_CPLUSPLUS_API

/**
 * \file
 * \brief C++ API: NumberingSystem object
 */

#if !UCONFIG_NO_FORMATTING

#include "unicode/format.h"
#include "unicode/uobject.h"

U_NAMESPACE_BEGIN

// can't be #ifndef U_HIDE_INTERNAL_API; needed for char[] field size
/**
 * Size of a numbering system name.
 * @internal
 */
constexpr const size_t kInternalNumSysNameCapacity = 8;

/**
 * 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., in a
 * positional numbering system with a specified radix (typically 10).
 * 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.
     *
     * @stable ICU 4.2
     */
    NumberingSystem();

    /**
     * Copy constructor.
     * @stable ICU 4.2
     */
    NumberingSystem(const NumberingSystem& other);

    /**
     * Copy assignment.
     * @stable ICU 4.2
     */
    NumberingSystem& operator=(const NumberingSystem& other) = default;

    /**
     * Destructor.
     * @stable ICU 4.2
     */
    virtual ~NumberingSystem();

    /**
     * Create the default numbering system associated with the specified locale.
     * @param inLocale The given locale.
     * @param status ICU status
     * @stable ICU 4.2
     */
    static NumberingSystem* U_EXPORT2 createInstance(const Locale & inLocale, UErrorCode& status);

    /**
     * Create the default numbering system associated with the default locale.
     * @stable ICU 4.2
     */
    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
     * @stable ICU 4.2
     */
    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.
     * The numbering system names will be in alphabetical (invariant) order.
     *
     * The returned StringEnumeration is owned by the caller, who must delete it when
     * finished with it.
     *
     * @stable ICU 4.2
     */
     static StringEnumeration * U_EXPORT2 getAvailableNames(UErrorCode& status);

    /**
     * Create a numbering system from one of the predefined numbering systems specified
     * by CLDR and known to ICU, such as "latn", "arabext", or "hanidec"; the full list
     * is returned by unumsys_openAvailableNames. Note that some of the names listed at
     * http://unicode.org/repos/cldr/tags/latest/common/bcp47/number.xml - e.g.
     * default, native, traditional, finance - do not identify specific numbering systems,
     * but rather key values that may only be used as part of a locale, which in turn
     * defines how they are mapped to a specific numbering system such as "latn" or "hant".
     *
     * @param name   The name of the numbering system.
     * @param status ICU status; set to U_UNSUPPORTED_ERROR if numbering system not found.
     * @return The NumberingSystem instance, or nullptr if not found.
     * @stable ICU 4.2
     */
    static NumberingSystem* U_EXPORT2 createInstanceByName(const char* name, UErrorCode& status);


    /**
     * Returns the radix of this numbering system. Simple positional numbering systems
     * typically have radix 10, but might have a radix of e.g. 16 for hexadecimal. The
     * radix is less well-defined for non-positional algorithmic systems.
     * @stable ICU 4.2
     */
    int32_t getRadix() const;

    /**
     * Returns the name of this numbering system if it was created using one of the predefined names
     * known to ICU.  Otherwise, returns NULL.
     * The predefined names are identical to the numbering system names as defined by
     * the BCP47 definition in Unicode CLDR.
     * See also, http://www.unicode.org/repos/cldr/tags/latest/common/bcp47/number.xml
     * @stable ICU 4.6
     */
    const char * getName() const;

    /**
     * Returns the description string of this numbering system. For simple
     * positional systems this is the ordered string of digits (with length matching
     * the radix), e.g. "\u3007\u4E00\u4E8C\u4E09\u56DB\u4E94\u516D\u4E03\u516B\u4E5D"
     * for "hanidec"; it would be "0123456789ABCDEF" for hexadecimal. For
     * algorithmic systems this is the name of the RBNF ruleset used for formatting,
     * e.g. "zh/SpelloutRules/%spellout-cardinal" for "hans" or "%greek-upper" for
     * "grek".
     * @stable ICU 4.2
     */
    virtual UnicodeString getDescription() const;



    /**
     * Returns true if the given numbering system is algorithmic
     *
     * @return         true if the numbering system is algorithmic.
     *                 Otherwise, return false.
     * @stable ICU 4.2
     */
    UBool isAlgorithmic() const;

    /**
     * ICU "poor man's RTTI", returns a UClassID for this class.
     *
     * @stable ICU 4.2
     *
    */
    static UClassID U_EXPORT2 getStaticClassID(void);

    /**
     * ICU "poor man's RTTI", returns a UClassID for the actual class.
     *
     * @stable ICU 4.2
     */
    virtual UClassID getDynamicClassID() const;


private:
    UnicodeString   desc;
    int32_t         radix;
    UBool           algorithmic;
    char            name[kInternalNumSysNameCapacity+1];

    void setRadix(int32_t radix);

    void setAlgorithmic(UBool algorithmic);

    void setDesc(const UnicodeString &desc);

    void setName(const char* name);

    static UBool isValidDigitString(const UnicodeString &str);

    UBool hasContiguousDecimalDigits() const;
};

U_NAMESPACE_END

#endif /* #if !UCONFIG_NO_FORMATTING */

#endif /* U_SHOW_CPLUSPLUS_API */

#endif // _NUMSYS
//eof

Coverage Report

Created: 2025-06-24 06:43

Line	Count	Source (jump to first uncovered line)
1		// © 2016 and later: Unicode, Inc. and others.
2		// License & terms of use: http://www.unicode.org/copyright.html
3		/*
4		*******************************************************************************
5		* Copyright (C) 2010-2014, International Business Machines Corporation and
6		* others. All Rights Reserved.
7		*******************************************************************************
8		*
9		*
10		* File NUMSYS.H
11		*
12		* Modification History:*
13		* Date Name Description
14		*
15		********************************************************************************
16		*/
17
18		#ifndef NUMSYS
19		#define NUMSYS
20
21		#include "unicode/utypes.h"
22
23		#if U_SHOW_CPLUSPLUS_API
24
25		/**
26		* \file
27		* \brief C++ API: NumberingSystem object
28		*/
29
30		#if !UCONFIG_NO_FORMATTING
31
32		#include "unicode/format.h"
33		#include "unicode/uobject.h"
34
35		U_NAMESPACE_BEGIN
36
37		// can't be #ifndef U_HIDE_INTERNAL_API; needed for char[] field size
38		/**
39		* Size of a numbering system name.
40		* @internal
41		*/
42		constexpr const size_t kInternalNumSysNameCapacity = 8;
43
44		/**
45		* Defines numbering systems. A numbering system describes the scheme by which
46		* numbers are to be presented to the end user. In its simplest form, a numbering
47		* system describes the set of digit characters that are to be used to display
48		* numbers, such as Western digits, Thai digits, Arabic-Indic digits, etc., in a
49		* positional numbering system with a specified radix (typically 10).
50		* More complicated numbering systems are algorithmic in nature, and require use
51		* of an RBNF formatter ( rule based number formatter ), in order to calculate
52		* the characters to be displayed for a given number. Examples of algorithmic
53		* numbering systems include Roman numerals, Chinese numerals, and Hebrew numerals.
54		* Formatting rules for many commonly used numbering systems are included in
55		* the ICU package, based on the numbering system rules defined in CLDR.
56		* Alternate numbering systems can be specified to a locale by using the
57		* numbers locale keyword.
58		*/
59
60		class U_I18N_API NumberingSystem : public UObject {
61		public:
62
63		/**
64		* Default Constructor.
65		*
66		* @stable ICU 4.2
67		*/
68		NumberingSystem();
69
70		/**
71		* Copy constructor.
72		* @stable ICU 4.2
73		*/
74		NumberingSystem(const NumberingSystem& other);
75
76		/**
77		* Copy assignment.
78		* @stable ICU 4.2
79		*/
80	0	NumberingSystem& operator=(const NumberingSystem& other) = default;
81
82		/**
83		* Destructor.
84		* @stable ICU 4.2
85		*/
86		virtual ~NumberingSystem();
87
88		/**
89		* Create the default numbering system associated with the specified locale.
90		* @param inLocale The given locale.
91		* @param status ICU status
92		* @stable ICU 4.2
93		*/
94		static NumberingSystem* U_EXPORT2 createInstance(const Locale & inLocale, UErrorCode& status);
95
96		/**
97		* Create the default numbering system associated with the default locale.
98		* @stable ICU 4.2
99		*/
100		static NumberingSystem* U_EXPORT2 createInstance(UErrorCode& status);
101
102		/**
103		* Create a numbering system using the specified radix, type, and description.
104		* @param radix The radix (base) for this numbering system.
105		* @param isAlgorithmic true if the numbering system is algorithmic rather than numeric.
106		* @param description The string representing the set of digits used in a numeric system, or the name of the RBNF
107		* ruleset to be used in an algorithmic system.
108		* @param status ICU status
109		* @stable ICU 4.2
110		*/
111		static NumberingSystem* U_EXPORT2 createInstance(int32_t radix, UBool isAlgorithmic, const UnicodeString& description, UErrorCode& status );
112
113		/**
114		* Return a StringEnumeration over all the names of numbering systems known to ICU.
115		* The numbering system names will be in alphabetical (invariant) order.
116		*
117		* The returned StringEnumeration is owned by the caller, who must delete it when
118		* finished with it.
119		*
120		* @stable ICU 4.2
121		*/
122		static StringEnumeration * U_EXPORT2 getAvailableNames(UErrorCode& status);
123
124		/**
125		* Create a numbering system from one of the predefined numbering systems specified
126		* by CLDR and known to ICU, such as "latn", "arabext", or "hanidec"; the full list
127		* is returned by unumsys_openAvailableNames. Note that some of the names listed at
128		* http://unicode.org/repos/cldr/tags/latest/common/bcp47/number.xml - e.g.
129		* default, native, traditional, finance - do not identify specific numbering systems,
130		* but rather key values that may only be used as part of a locale, which in turn
131		* defines how they are mapped to a specific numbering system such as "latn" or "hant".
132		*
133		* @param name The name of the numbering system.
134		* @param status ICU status; set to U_UNSUPPORTED_ERROR if numbering system not found.
135		* @return The NumberingSystem instance, or nullptr if not found.
136		* @stable ICU 4.2
137		*/
138		static NumberingSystem* U_EXPORT2 createInstanceByName(const char* name, UErrorCode& status);
139
140
141		/**
142		* Returns the radix of this numbering system. Simple positional numbering systems
143		* typically have radix 10, but might have a radix of e.g. 16 for hexadecimal. The
144		* radix is less well-defined for non-positional algorithmic systems.
145		* @stable ICU 4.2
146		*/
147		int32_t getRadix() const;
148
149		/**
150		* Returns the name of this numbering system if it was created using one of the predefined names
151		* known to ICU. Otherwise, returns NULL.
152		* The predefined names are identical to the numbering system names as defined by
153		* the BCP47 definition in Unicode CLDR.
154		* See also, http://www.unicode.org/repos/cldr/tags/latest/common/bcp47/number.xml
155		* @stable ICU 4.6
156		*/
157		const char * getName() const;
158
159		/**
160		* Returns the description string of this numbering system. For simple
161		* positional systems this is the ordered string of digits (with length matching
162		* the radix), e.g. "\u3007\u4E00\u4E8C\u4E09\u56DB\u4E94\u516D\u4E03\u516B\u4E5D"
163		* for "hanidec"; it would be "0123456789ABCDEF" for hexadecimal. For
164		* algorithmic systems this is the name of the RBNF ruleset used for formatting,
165		* e.g. "zh/SpelloutRules/%spellout-cardinal" for "hans" or "%greek-upper" for
166		* "grek".
167		* @stable ICU 4.2
168		*/
169		virtual UnicodeString getDescription() const;
170
171
172
173		/**
174		* Returns true if the given numbering system is algorithmic
175		*
176		* @return true if the numbering system is algorithmic.
177		* Otherwise, return false.
178		* @stable ICU 4.2
179		*/
180		UBool isAlgorithmic() const;
181
182		/**
183		* ICU "poor man's RTTI", returns a UClassID for this class.
184		*
185		* @stable ICU 4.2
186		*
187		*/
188		static UClassID U_EXPORT2 getStaticClassID(void);
189
190		/**
191		* ICU "poor man's RTTI", returns a UClassID for the actual class.
192		*
193		* @stable ICU 4.2
194		*/
195		virtual UClassID getDynamicClassID() const;
196
197
198		private:
199		UnicodeString desc;
200		int32_t radix;
201		UBool algorithmic;
202		char name[kInternalNumSysNameCapacity+1];
203
204		void setRadix(int32_t radix);
205
206		void setAlgorithmic(UBool algorithmic);
207
208		void setDesc(const UnicodeString &desc);
209
210		void setName(const char* name);
211
212		static UBool isValidDigitString(const UnicodeString &str);
213
214		UBool hasContiguousDecimalDigits() const;
215		};
216
217		U_NAMESPACE_END
218
219		#endif /* #if !UCONFIG_NO_FORMATTING */
220
221		#endif /* U_SHOW_CPLUSPLUS_API */
222
223		#endif // _NUMSYS
224		//eof