NSNumberFormatter Class Reference

Tasks

Configuring Formatter Behavior and Style

• – setFormatterBehavior:
• – formatterBehavior
• + setDefaultFormatterBehavior:
• + defaultFormatterBehavior
• – setNumberStyle:
• – numberStyle
• – setGeneratesDecimalNumbers:
• – generatesDecimalNumbers

Converting Between Numbers and Strings

• – getObjectValue:forString:range:error:
• – numberFromString:
• – stringFromNumber:
• + localizedStringFromNumber:numberStyle:

Managing Localization of Numbers

• – setLocale:
• – locale

Configuring Rounding Behavior

• – setRoundingIncrement:
• – roundingIncrement
• – setRoundingMode:
• – roundingMode

Configuring Numeric Formats

• – setFormatWidth:
• – formatWidth
• – setNegativeFormat:
• – negativeFormat
• – setPositiveFormat:
• – positiveFormat
• – setMultiplier:
• – multiplier

Configuring Numeric Symbols

• – setPercentSymbol:
• – percentSymbol
• – setPerMillSymbol:
• – perMillSymbol
• – setMinusSign:
• – minusSign
• – setPlusSign:
• – plusSign
• – setExponentSymbol:
• – exponentSymbol
• – setZeroSymbol:
• – zeroSymbol
• – setNilSymbol:
• – nilSymbol
• – setNotANumberSymbol:
• – notANumberSymbol
• – setNegativeInfinitySymbol:
• – negativeInfinitySymbol
• – setPositiveInfinitySymbol:
• – positiveInfinitySymbol

Configuring the Format of Currency

• – setCurrencySymbol:
• – currencySymbol
• – setCurrencyCode:
• – currencyCode
• – setInternationalCurrencySymbol:
• – internationalCurrencySymbol
• – setCurrencyGroupingSeparator:
• – currencyGroupingSeparator

Configuring Numeric Prefixes and Suffixes

• – setPositivePrefix:
• – positivePrefix
• – setPositiveSuffix:
• – positiveSuffix
• – setNegativePrefix:
• – negativePrefix
• – setNegativeSuffix:
• – negativeSuffix

Configuring the Display of Numeric Values

• – setTextAttributesForNegativeValues:
• – textAttributesForNegativeValues
• – setTextAttributesForPositiveValues:
• – textAttributesForPositiveValues
• – setTextAttributesForZero:
• – textAttributesForZero
• – setTextAttributesForNil:
• – textAttributesForNil
• – setTextAttributesForNotANumber:
• – textAttributesForNotANumber
• – setTextAttributesForPositiveInfinity:
• – textAttributesForPositiveInfinity
• – setTextAttributesForNegativeInfinity:
• – textAttributesForNegativeInfinity

Configuring Separators and Grouping Size

• – setGroupingSeparator:
• – groupingSeparator
• – setUsesGroupingSeparator:
• – usesGroupingSeparator
• – setDecimalSeparator:
• – decimalSeparator
• – setAlwaysShowsDecimalSeparator:
• – alwaysShowsDecimalSeparator
• – setCurrencyDecimalSeparator:
• – currencyDecimalSeparator
• – setGroupingSize:
• – groupingSize
• – setSecondaryGroupingSize:
• – secondaryGroupingSize

Managing the Padding of Numbers

• – setPaddingCharacter:
• – paddingCharacter
• – setPaddingPosition:
• – paddingPosition

Managing Input and Output Attributes

• – setAllowsFloats:
• – allowsFloats
• – setMinimum:
• – minimum
• – setMaximum:
• – maximum
• – setMinimumIntegerDigits:
• – minimumIntegerDigits
• – setMinimumFractionDigits:
• – minimumFractionDigits
• – setMaximumIntegerDigits:
• – maximumIntegerDigits
• – setMaximumFractionDigits:
• – maximumFractionDigits

Configuring Significant Digits

• – setUsesSignificantDigits:
• – usesSignificantDigits
• – setMinimumSignificantDigits:
• – minimumSignificantDigits
• – setMaximumSignificantDigits:
• – maximumSignificantDigits

Managing Leniency Behavior

• – setLenient:
• – isLenient

Managing the Validation of Partial Numeric Strings

• – setPartialStringValidationEnabled:
• – isPartialStringValidationEnabled

NSNumberFormatter *numberFormatter =

    [[[NSNumberFormatter alloc] init] autorelease];

NSMutableDictionary *newAttrs = [NSMutableDictionary dictionary];

[numberFormatter setFormat:@"$#,##0.00;($#,##0.00)"];

[newAttrs setObject:[NSColor redColor] forKey:@"NSColor"];

[numberFormatter setTextAttributesForNegativeValues:newAttrs];

[[textField cell] setFormatter:numberFormatter];

[numberFormatter setFormat:@"$#,##0.00;[Red]($#,##0.00)"];

enum {
   NSNumberFormatterNoStyle = kCFNumberFormatterNoStyle,
   NSNumberFormatterDecimalStyle = kCFNumberFormatterDecimalStyle,
   NSNumberFormatterCurrencyStyle = kCFNumberFormatterCurrencyStyle,
   NSNumberFormatterPercentStyle = kCFNumberFormatterPercentStyle,
   NSNumberFormatterScientificStyle = kCFNumberFormatterScientificStyle,
   NSNumberFormatterSpellOutStyle = kCFNumberFormatterSpellOutStyle
};
typedef NSUInteger NSNumberFormatterStyle;

enum {
   NSNumberFormatterBehaviorDefault = 0,
   NSNumberFormatterBehavior10_0 = 1000,
   NSNumberFormatterBehavior10_4 = 1040,
};
typedef NSUInteger NSNumberFormatterBehavior;

enum {
   NSNumberFormatterPadBeforePrefix = kCFNumberFormatterPadBeforePrefix,
   NSNumberFormatterPadAfterPrefix = kCFNumberFormatterPadAfterPrefix,
   NSNumberFormatterPadBeforeSuffix = kCFNumberFormatterPadBeforeSuffix,
   NSNumberFormatterPadAfterSuffix = kCFNumberFormatterPadAfterSuffix
};
typedef NSUInteger NSNumberFormatterPadPosition;

enum {
   NSNumberFormatterRoundCeiling = kCFNumberFormatterRoundCeiling,
   NSNumberFormatterRoundFloor = kCFNumberFormatterRoundFloor,
   NSNumberFormatterRoundDown = kCFNumberFormatterRoundDown,
   NSNumberFormatterRoundUp = kCFNumberFormatterRoundUp,
   NSNumberFormatterRoundHalfEven = kCFNumberFormatterRoundHalfEven,
   NSNumberFormatterRoundHalfDown = kCFNumberFormatterRoundHalfDown,
   NSNumberFormatterRoundHalfUp = kCFNumberFormatterRoundHalfUp
};
typedef NSUInteger NSNumberFormatterRoundingMode;