Main Page   Class Hierarchy   Compound List   File List   Header Files   Sources   Compound Members   File Members  

DecimalFormatSymbols Class Reference

This class represents the set of symbols needed by DecimalFormat to format numbers. More...

#include <dcfmtsym.h>

List of all members.


Public Members

enum  ENumberFormatSymbol { kDecimalSeparatorSymbol, kGroupingSeparatorSymbol, kPatternSeparatorSymbol, kPercentSymbol, kZeroDigitSymbol, kDigitSymbol, kMinusSignSymbol, kPlusSignSymbol, kCurrencySymbol, kIntlCurrencySymbol, kMonetarySeparatorSymbol, kExponentialSymbol, kPermillSymbol, kPadEscapeSymbol, kInfinitySymbol, kNaNSymbol, kFormatSymbolCount }
Constants for specifying a number format symbol. More...

 DecimalFormatSymbols (const Locale& locale, UErrorCode& status)
Create a DecimalFormatSymbols object for the given locale. More...

 DecimalFormatSymbols ( UErrorCode& status)
Create a DecimalFormatSymbols object for the default locale. More...

 DecimalFormatSymbols (const DecimalFormatSymbols&)
Copy constructor. More...

DecimalFormatSymbols& operator= (const DecimalFormatSymbols&)
Assignment operator. More...

 ~DecimalFormatSymbols ()
Destructor. More...

UBool operator== (const DecimalFormatSymbols& other) const
Return true if another object is semantically equal to this one. More...

UBool operator!= (const DecimalFormatSymbols& other) const
Return true if another object is semantically unequal to this one. More...

UnicodeString getSymbol (ENumberFormatSymbol symbol) const
Get one of the format symbols by its enum constant. More...

void setSymbol (ENumberFormatSymbol symbol, UnicodeString value)
Set one of the format symbols by its enum constant. More...

UChar getZeroDigit (void) const
character used for zero. More...

void setZeroDigit (UChar zeroDigit)
character used for zero. More...

UChar getGroupingSeparator (void) const
character used for thousands separator. More...

void setGroupingSeparator (UChar groupingSeparator)
character used for thousands separator. More...

UChar getDecimalSeparator (void) const
character used for decimal sign. More...

void setDecimalSeparator (UChar decimalSeparator)
character used for decimal sign. More...

UChar getPerMill (void) const
character used for per mill sign. More...

void setPerMill (UChar permill)
character used for per mill sign. More...

UChar getPercent (void) const
character used for percent sign. More...

void setPercent (UChar percent)
character used for percent sign. More...

UChar getDigit (void) const
character used for a digit in a pattern. More...

void setDigit (UChar digit)
character used for a digit in a pattern. More...

UChar getPatternSeparator (void) const
character used to separate positive and negative subpatterns in a pattern. More...

void setPatternSeparator (UChar patternSeparator)
character used to separate positive and negative subpatterns in a pattern. More...

UnicodeStringgetInfinity (UnicodeString& result) const
character used to represent infinity. More...

void setInfinity (const UnicodeString& infinity)
character used to represent infinity. More...

UnicodeStringgetNaN (UnicodeString& result) const
character used to represent NaN. More...

void setNaN (const UnicodeString& NaN)
character used to represent NaN. More...

UChar getPlusSign (void) const
character used to represent plus sign. More...

void setPlusSign (UChar minusSign)
character used to represent plus sign. More...

UChar getMinusSign (void) const
character used to represent minus sign. More...

void setMinusSign (UChar minusSign)
character used to represent minus sign. More...

UChar getExponentialSymbol (void) const
character used to represent exponential. More...

void setExponentialSymbol (UChar exponential)
character used to represent exponential. More...

UnicodeStringgetCurrencySymbol (UnicodeString& result) const
The string denoting the local currency. More...

void setCurrencySymbol (const UnicodeString& currency)
The string denoting the local currency. More...

UnicodeStringgetInternationalCurrencySymbol (UnicodeString& result) const
The international string denoting the local currency. More...

void setInternationalCurrencySymbol (const UnicodeString& currency)
The international string denoting the local currency. More...

UChar getMonetaryDecimalSeparator (void) const
The monetary decimal separator. More...

void setMonetaryDecimalSeparator (UChar sep)
The monetary decimal separator. More...

UChar getPadEscape (void) const
Return the character used to pad numbers out to a specified width. More...

void setPadEscape (UChar c)
Set the character used to pad numbers out to a specified width. More...


Detailed Description

This class represents the set of symbols needed by DecimalFormat to format numbers.

DecimalFormat creates for itself an instance of DecimalFormatSymbols from its locale data. If you need to change any of these symbols, you can get the DecimalFormatSymbols object from your DecimalFormat and modify it.

Here are the special characters used in the parts of the subpattern, with notes on their usage.

 .       Symbol   Meaning
 .         0      a digit
 .         #      a digit, zero shows as absent
 .         .      placeholder for decimal separator
 .         ,      placeholder for grouping separator.
 .         ;      separates formats.
 .         -      default negative prefix.
 .         %      divide by 100 and show as percentage
 .         X      any other characters can be used in the prefix or suffix
 .         '      used to quote special characters in a prefix or suffix.
  
[Notes]

If there is no explicit negative subpattern, - is prefixed to the positive form. That is, "0.00" alone is equivalent to "0.00;-0.00".

The grouping separator is commonly used for thousands, but in some countries for ten-thousands. The interval is a constant number of digits between the grouping characters, such as 100,000,000 or 1,0000,0000. If you supply a pattern with multiple grouping characters, the interval between the last one and the end of the integer is the one that is used. So "#,##,###,####" == "######,####" == "##,####,####".

This class only handles localized digits where the 10 digits are contiguous in Unicode, from 0 to 9. Other digits sets (such as superscripts) would need a different subclass.

Definition at line 67 of file dcfmtsym.h.


Member Enumeration Documentation

enum DecimalFormatSymbols::ENumberFormatSymbol

Constants for specifying a number format symbol.

Draft:
Enumeration values:
kDecimalSeparatorSymbol   The decimal separator.
kGroupingSeparatorSymbol   The grouping separator.
kPatternSeparatorSymbol   The pattern separator.
kPercentSymbol   The percent sign.
kZeroDigitSymbol   Zero.
kDigitSymbol   Character representing a digit in the pattern.
kMinusSignSymbol   The minus sign.
kPlusSignSymbol   The plus sign.
kCurrencySymbol   The currency symbol.
kIntlCurrencySymbol   The international currency symbol.
kMonetarySeparatorSymbol   The monetary separator.
kExponentialSymbol   The exponential symbol.
kPermillSymbol   Per mill symbol.
kPadEscapeSymbol   Escape padding character.
kInfinitySymbol   Infinity symbol.
kNaNSymbol   Nan symbol.
kFormatSymbolCount   count symbol constants.

Definition at line 73 of file dcfmtsym.h.


Member Function Documentation

DecimalFormatSymbols::DecimalFormatSymbols (const Locale & locale, UErrorCode & status)

Create a DecimalFormatSymbols object for the given locale.

Parameters:
locale   The locale to get symbols for.
status   Input/output parameter, set to success or failure code upon return.
Stable:

DecimalFormatSymbols::DecimalFormatSymbols (UErrorCode & status)

Create a DecimalFormatSymbols object for the default locale.

This constructor will not fail. If the resource file data is not available, it will use hard-coded last-resort data and set status to U_USING_FALLBACK_ERROR.

Parameters:
status   Input/output parameter, set to success or failure code upon return.
Stable:

DecimalFormatSymbols::DecimalFormatSymbols (const DecimalFormatSymbols &)

Copy constructor.

Stable:

DecimalFormatSymbols & DecimalFormatSymbols::operator= (const DecimalFormatSymbols &)

Assignment operator.

Stable:

DecimalFormatSymbols::~DecimalFormatSymbols ()

Destructor.

Stable:

UBool DecimalFormatSymbols::operator== (const DecimalFormatSymbols & other) const

Return true if another object is semantically equal to this one.

Stable:

UBool DecimalFormatSymbols::operator!= (const DecimalFormatSymbols & other) const [inline]

Return true if another object is semantically unequal to this one.

Stable:

Definition at line 160 of file dcfmtsym.h.

UnicodeString DecimalFormatSymbols::getSymbol (ENumberFormatSymbol symbol) const [inline]

Get one of the format symbols by its enum constant.

Each symbol is stored as a string so that graphemes (characters with modifyer letters) can be used.

Draft:

Definition at line 408 of file dcfmtsym.h.

void DecimalFormatSymbols::setSymbol (ENumberFormatSymbol symbol, UnicodeString value) [inline]

Set one of the format symbols by its enum constant.

Each symbol is stored as a string so that graphemes (characters with modifyer letters) can be used.

Draft:

Definition at line 419 of file dcfmtsym.h.

UChar DecimalFormatSymbols::getZeroDigit (void) const [inline]

character used for zero.

Different for Arabic, etc.

Deprecated:
remove after 2000-dec-31

Definition at line 428 of file dcfmtsym.h.

void DecimalFormatSymbols::setZeroDigit (UChar zeroDigit) [inline]

character used for zero.

Different for Arabic, etc.

Deprecated:
remove after 2000-dec-31

Definition at line 436 of file dcfmtsym.h.

UChar DecimalFormatSymbols::getGroupingSeparator (void) const [inline]

character used for thousands separator.

Different for French, etc.

Deprecated:
remove after 2000-dec-31

Definition at line 444 of file dcfmtsym.h.

void DecimalFormatSymbols::setGroupingSeparator (UChar groupingSeparator) [inline]

character used for thousands separator.

Different for French, etc.

Deprecated:
remove after 2000-dec-31

Definition at line 452 of file dcfmtsym.h.

UChar DecimalFormatSymbols::getDecimalSeparator (void) const [inline]

character used for decimal sign.

Different for French, etc.

Deprecated:
remove after 2000-dec-31

Definition at line 460 of file dcfmtsym.h.

void DecimalFormatSymbols::setDecimalSeparator (UChar decimalSeparator) [inline]

character used for decimal sign.

Different for French, etc.

Deprecated:
remove after 2000-dec-31

Definition at line 468 of file dcfmtsym.h.

UChar DecimalFormatSymbols::getPerMill (void) const [inline]

character used for per mill sign.

Different for Arabic, etc.

Deprecated:
remove after 2000-dec-31

Definition at line 476 of file dcfmtsym.h.

void DecimalFormatSymbols::setPerMill (UChar permill) [inline]

character used for per mill sign.

Different for Arabic, etc.

Deprecated:
remove after 2000-dec-31

Definition at line 484 of file dcfmtsym.h.

UChar DecimalFormatSymbols::getPercent (void) const [inline]

character used for percent sign.

Different for Arabic, etc.

Deprecated:
remove after 2000-dec-31

Definition at line 492 of file dcfmtsym.h.

void DecimalFormatSymbols::setPercent (UChar percent) [inline]

character used for percent sign.

Different for Arabic, etc.

Deprecated:
remove after 2000-dec-31

Definition at line 500 of file dcfmtsym.h.

UChar DecimalFormatSymbols::getDigit (void) const [inline]

character used for a digit in a pattern.

Deprecated:
remove after 2000-dec-31

Definition at line 508 of file dcfmtsym.h.

void DecimalFormatSymbols::setDigit (UChar digit) [inline]

character used for a digit in a pattern.

Deprecated:
remove after 2000-dec-31

Definition at line 516 of file dcfmtsym.h.

UChar DecimalFormatSymbols::getPatternSeparator (void) const [inline]

character used to separate positive and negative subpatterns in a pattern.

Deprecated:
remove after 2000-dec-31

Definition at line 524 of file dcfmtsym.h.

void DecimalFormatSymbols::setPatternSeparator (UChar patternSeparator) [inline]

character used to separate positive and negative subpatterns in a pattern.

Deprecated:
remove after 2000-dec-31

Definition at line 532 of file dcfmtsym.h.

UnicodeString & DecimalFormatSymbols::getInfinity (UnicodeString & result) const [inline]

character used to represent infinity.

Almost always left unchanged.

Deprecated:
remove after 2000-dec-31

Definition at line 540 of file dcfmtsym.h.

void DecimalFormatSymbols::setInfinity (const UnicodeString & infinity) [inline]

character used to represent infinity.

Almost always left unchanged.

Deprecated:
remove after 2000-dec-31

Definition at line 548 of file dcfmtsym.h.

UnicodeString & DecimalFormatSymbols::getNaN (UnicodeString & result) const [inline]

character used to represent NaN.

Almost always left unchanged.

Deprecated:
remove after 2000-dec-31

Definition at line 556 of file dcfmtsym.h.

void DecimalFormatSymbols::setNaN (const UnicodeString & NaN) [inline]

character used to represent NaN.

Almost always left unchanged.

Deprecated:
remove after 2000-dec-31

Definition at line 564 of file dcfmtsym.h.

UChar DecimalFormatSymbols::getPlusSign (void) const [inline]

character used to represent plus sign.

Deprecated:
remove after 2000-dec-31

Definition at line 572 of file dcfmtsym.h.

void DecimalFormatSymbols::setPlusSign (UChar plusSign) [inline]

character used to represent plus sign.

Deprecated:
remove after 2000-dec-31

Definition at line 580 of file dcfmtsym.h.

UChar DecimalFormatSymbols::getMinusSign (void) const [inline]

character used to represent minus sign.

If no explicit negative format is specified, one is formed by prefixing minusSign to the positive format.

Deprecated:
remove after 2000-dec-31

Definition at line 588 of file dcfmtsym.h.

void DecimalFormatSymbols::setMinusSign (UChar minusSign) [inline]

character used to represent minus sign.

If no explicit negative format is specified, one is formed by prefixing minusSign to the positive format.

Deprecated:
remove after 2000-dec-31

Definition at line 596 of file dcfmtsym.h.

UChar DecimalFormatSymbols::getExponentialSymbol (void) const [inline]

character used to represent exponential.

Almost always left unchanged.

Deprecated:
remove after 2000-dec-31

Definition at line 604 of file dcfmtsym.h.

void DecimalFormatSymbols::setExponentialSymbol (UChar exponential) [inline]

character used to represent exponential.

Almost always left unchanged.

Deprecated:
remove after 2000-dec-31

Definition at line 612 of file dcfmtsym.h.

UnicodeString & DecimalFormatSymbols::getCurrencySymbol (UnicodeString & result) const [inline]

The string denoting the local currency.

Deprecated:
remove after 2000-dec-31

Definition at line 620 of file dcfmtsym.h.

void DecimalFormatSymbols::setCurrencySymbol (const UnicodeString & str) [inline]

The string denoting the local currency.

Deprecated:
remove after 2000-dec-31

Definition at line 628 of file dcfmtsym.h.

UnicodeString & DecimalFormatSymbols::getInternationalCurrencySymbol (UnicodeString & result) const [inline]

The international string denoting the local currency.

Deprecated:
remove after 2000-dec-31

Definition at line 636 of file dcfmtsym.h.

void DecimalFormatSymbols::setInternationalCurrencySymbol (const UnicodeString & str) [inline]

The international string denoting the local currency.

Deprecated:
remove after 2000-dec-31

Definition at line 644 of file dcfmtsym.h.

UChar DecimalFormatSymbols::getMonetaryDecimalSeparator (void) const [inline]

The monetary decimal separator.

Deprecated:
remove after 2000-dec-31

Definition at line 652 of file dcfmtsym.h.

void DecimalFormatSymbols::setMonetaryDecimalSeparator (UChar sep) [inline]

The monetary decimal separator.

Deprecated:
remove after 2000-dec-31

Definition at line 660 of file dcfmtsym.h.

UChar DecimalFormatSymbols::getPadEscape (void) const [inline]

Return the character used to pad numbers out to a specified width.

This is not the pad character itself; rather, it is the special pattern character preceding the pad character. In the pattern "*_#,##0", '*' is the pad escape, and '_' is the pad character.

Returns:
the character
See also:
setPadEscape() , DecimalFormat::getFormatWidth() , DecimalFormat::getPadPosition() , DecimalFormat::getPadCharacter()
Deprecated:
remove after 2000-dec-31

Definition at line 665 of file dcfmtsym.h.

void DecimalFormatSymbols::setPadEscape (UChar c) [inline]

Set the character used to pad numbers out to a specified width.

This is not the pad character itself; rather, it is the special pattern character preceding the pad character. In the pattern "*_#,##0", '*' is the pad escape, and '_' is the pad character.

See also:
getPadEscape() , DecimalFormat::setFormatWidth() , DecimalFormat::setPadPosition() , DecimalFormat::setPadCharacter()
Deprecated:
remove after 2000-dec-31

Definition at line 669 of file dcfmtsym.h.


The documentation for this class was generated from the following file:
Generated at Mon Jun 5 12:53:15 2000 for ICU1.5 by doxygen 1.0.0 written by Dimitri van Heesch, © 1997-1999