Number Formatter Property Keys

The keys used in key-value pairs to specify the value of number formatter properties.

Overview

The values for these keys are all CFType objects. The specific types for each key are specified above.

Topics

Constants

kCFNumberFormatterCurrencyCode

Specifies the currency code, a CFString object.

kCFNumberFormatterDecimalSeparator

Specifies the decimal separator, a CFString object.

kCFNumberFormatterCurrencyDecimalSeparator

Specifies the currency decimal separator, a CFString object.

kCFNumberFormatterAlwaysShowDecimalSeparator

Specifies if the result of converting a value to a string should always contain the decimal separator, even if the number is an integer.

kCFNumberFormatterGroupingSeparator

Specifies the grouping separator, a CFString object.

kCFNumberFormatterUseGroupingSeparator

Specifies if the grouping separator should be used, a CFBoolean object.

kCFNumberFormatterPercentSymbol

Specifies the string that is used to represent the percent symbol, a CFString object.

kCFNumberFormatterZeroSymbol

Specifies the string that is used to represent zero, a CFString object.

kCFNumberFormatterNaNSymbol

Specifies the string that is used to represent NaN (“not a number”) when values are converted to strings, a CFString object.

kCFNumberFormatterInfinitySymbol

Specifies the string that is used to represent the symbol for infinity, a CFString object.

kCFNumberFormatterMinusSign

Specifies the symbol for the minus sign, a CFString object.

kCFNumberFormatterPlusSign

Specifies the symbol for the plus sign, a CFString object.

kCFNumberFormatterCurrencySymbol

Specifies the symbol for the currency, a CFString object.

kCFNumberFormatterExponentSymbol

Specifies the exponent symbol (“E” or “e”) in the scientific notation of numbers (for example, as in 1.0e+56), a CFString object.

kCFNumberFormatterMinIntegerDigits

Specifies the minimum number of integer digits before a decimal point, a CFNumber object.

kCFNumberFormatterMaxIntegerDigits

Specifies the maximum number of integer digits before a decimal point, a CFNumber object.

kCFNumberFormatterMinFractionDigits

Specifies the minimum number of digits after a decimal point, a CFNumber object.

kCFNumberFormatterMaxFractionDigits

Specifies the maximum number of digits after a decimal point, a CFNumber object.

kCFNumberFormatterGroupingSize

Specifies how often the “thousands” or grouping separator appears, as in “10,000,000”, a CFNumber object.

kCFNumberFormatterSecondaryGroupingSize

Specifies how often the secondary grouping separator appears, a CFNumber object. See Creating and Using CFNumberFormatter Objects for more information.

kCFNumberFormatterRoundingMode

Specifies how the last digit is rounded, as when 3.1415926535… is rounded to three decimal places, as in 3.142. See CFNumberFormatterRoundingMode for possible values.

kCFNumberFormatterRoundingIncrement

Specifies a positive rounding increment, or 0.0 to disable rounding, a CFNumber object.

kCFNumberFormatterFormatWidth

Specifies the width of a formatted number within a string that is either left justified or right justified based on the value of kCFNumberFormatterPaddingPosition, a CFNumber object.

kCFNumberFormatterPaddingPosition

Specifies the position of a formatted number within a string, a CFNumber object.

kCFNumberFormatterPaddingCharacter

Specifies the padding character to use when placing a formatted number within a string, a CFString object.

kCFNumberFormatterDefaultFormat

The original format string for the formatter (given the date and time style and locale specified at creation), a CFString object.

kCFNumberFormatterMultiplier

Specifies the multiplier to use when placing a formatted number within a string, a CFNumber object.

kCFNumberFormatterPositivePrefix

Specifies the plus sign prefix symbol to use when placing a formatted number within a string, a CFString object.

kCFNumberFormatterPositiveSuffix

Specifies the plus sign suffix symbol to use when placing a formatted number within a string, a CFString object.

kCFNumberFormatterNegativePrefix

Specifies the minus sign prefix symbol to use when placing a formatted number within a string, a CFString object.

kCFNumberFormatterNegativeSuffix

Specifies the minus sign suffix symbol to use when placing a formatted number within a string, a CFString object.

kCFNumberFormatterPerMillSymbol

Specifies the per mill (1/1000) symbol to use when placing a formatted number within a string, a CFString object.

kCFNumberFormatterInternationalCurrencySymbol

Specifies the international currency symbol to use when placing a formatted number within a string, a CFString object.

kCFNumberFormatterCurrencyGroupingSeparator

Specifies the grouping symbol to use when placing a currency value within a string, a CFString object.

kCFNumberFormatterIsLenient

Specifies whether the formatter is lenient, aCFBoolean object.

kCFNumberFormatterUseSignificantDigits

Specifies the whether the formatter uses significant digits, a CFBoolean object.

kCFNumberFormatterMinSignificantDigits

Specifies the minimum number of significant digits to use, aCFNumber object.

kCFNumberFormatterMaxSignificantDigits

Specifies the maximum number of significant digits to use, aCFNumber object.