CFNumberFormatter.h

   1 /*
   2  * Copyright (c) 2014 Apple Inc. All rights reserved.
   3  *
   4  * @APPLE_LICENSE_HEADER_START@
   5  *
   6  * This file contains Original Code and/or Modifications of Original Code
   7  * as defined in and that are subject to the Apple Public Source License
   8  * Version 2.0 (the 'License'). You may not use this file except in
   9  * compliance with the License. Please obtain a copy of the License at
  10  * http://www.opensource.apple.com/apsl/ and read it before using this
  11  * file.
  12  *
  13  * The Original Code and all software distributed under the License are
  14  * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
  15  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
  16  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
  17  * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
  18  * Please see the License for the specific language governing rights and
  19  * limitations under the License.
  20  *
  21  * @APPLE_LICENSE_HEADER_END@
  22  */
  23
  24 /*      CFNumberFormatter.h
  25         Copyright (c) 2003-2014, Apple Inc. All rights reserved.
  26 */
  27
  28 #if !defined(__COREFOUNDATION_CFNUMBERFORMATTER__)
  29 #define __COREFOUNDATION_CFNUMBERFORMATTER__ 1
  30
  31 #include <CoreFoundation/CFBase.h>
  32 #include <CoreFoundation/CFNumber.h>
  33 #include <CoreFoundation/CFLocale.h>
  34
  35 CF_IMPLICIT_BRIDGING_ENABLED
  36 CF_EXTERN_C_BEGIN
  37
  38 typedef struct __CFNumberFormatter *CFNumberFormatterRef;
  39
  40 // CFNumberFormatters are not thread-safe.  Do not use one from multiple threads!
  41
  42 CF_EXPORT
  43 CFTypeID CFNumberFormatterGetTypeID(void);
  44
  45 typedef CF_ENUM(CFIndex, CFNumberFormatterStyle) {      // number format styles
  46         kCFNumberFormatterNoStyle = 0,
  47         kCFNumberFormatterDecimalStyle = 1,
  48         kCFNumberFormatterCurrencyStyle = 2,
  49         kCFNumberFormatterPercentStyle = 3,
  50         kCFNumberFormatterScientificStyle = 4,
  51         kCFNumberFormatterSpellOutStyle = 5
  52 };
  53
  54
  55 CF_EXPORT
  56 CFNumberFormatterRef CFNumberFormatterCreate(CFAllocatorRef allocator, CFLocaleRef locale, CFNumberFormatterStyle style);
  57         // Returns a CFNumberFormatter, localized to the given locale, which
  58         // will format numbers to the given style.
  59
  60 CF_EXPORT
  61 CFLocaleRef CFNumberFormatterGetLocale(CFNumberFormatterRef formatter);
  62
  63 CF_EXPORT
  64 CFNumberFormatterStyle CFNumberFormatterGetStyle(CFNumberFormatterRef formatter);
  65         // Get the properties with which the number formatter was created.
  66
  67 CF_EXPORT
  68 CFStringRef CFNumberFormatterGetFormat(CFNumberFormatterRef formatter);
  69
  70 CF_EXPORT
  71 void CFNumberFormatterSetFormat(CFNumberFormatterRef formatter, CFStringRef formatString);
  72         // Set the format description string of the number formatter.  This
  73         // overrides the style settings.  The format of the format string
  74         // is as defined by the ICU library, and is similar to that found
  75         // in Microsoft Excel and NSNumberFormatter.
  76         // The number formatter starts with a default format string defined
  77         // by the style argument with which it was created.
  78
  79
  80 CF_EXPORT
  81 CFStringRef CFNumberFormatterCreateStringWithNumber(CFAllocatorRef allocator, CFNumberFormatterRef formatter, CFNumberRef number);
  82
  83 CF_EXPORT
  84 CFStringRef CFNumberFormatterCreateStringWithValue(CFAllocatorRef allocator, CFNumberFormatterRef formatter, CFNumberType numberType, const void *valuePtr);
  85         // Create a string representation of the given number or value
  86         // using the current state of the number formatter.
  87
  88
  89 typedef CF_OPTIONS(CFOptionFlags, CFNumberFormatterOptionFlags) {
  90     kCFNumberFormatterParseIntegersOnly = 1     /* only parse integers */
  91 };
  92
  93 CF_EXPORT
  94 CFNumberRef CFNumberFormatterCreateNumberFromString(CFAllocatorRef allocator, CFNumberFormatterRef formatter, CFStringRef string, CFRange *rangep, CFOptionFlags options);
  95
  96 CF_EXPORT
  97 Boolean CFNumberFormatterGetValueFromString(CFNumberFormatterRef formatter, CFStringRef string, CFRange *rangep, CFNumberType numberType, void *valuePtr);
  98         // Parse a string representation of a number using the current state
  99         // of the number formatter.  The range parameter specifies the range
 100         // of the string in which the parsing should occur in input, and on
 101         // output indicates the extent that was used; this parameter can
 102         // be NULL, in which case the whole string may be used.  The
 103         // return value indicates whether some number was computed and
 104         // (if valuePtr is not NULL) stored at the location specified by
 105         // valuePtr.  The numberType indicates the type of value pointed
 106         // to by valuePtr.
 107
 108
 109 CF_EXPORT
 110 void CFNumberFormatterSetProperty(CFNumberFormatterRef formatter, CFStringRef key, CFTypeRef value);
 111
 112 CF_EXPORT
 113 CFTypeRef CFNumberFormatterCopyProperty(CFNumberFormatterRef formatter, CFStringRef key);
 114         // Set and get various properties of the number formatter, the set of
 115         // which may be expanded in the future.
 116
 117 CF_EXPORT const CFStringRef kCFNumberFormatterCurrencyCode;             // CFString
 118 CF_EXPORT const CFStringRef kCFNumberFormatterDecimalSeparator; // CFString
 119 CF_EXPORT const CFStringRef kCFNumberFormatterCurrencyDecimalSeparator; // CFString
 120 CF_EXPORT const CFStringRef kCFNumberFormatterAlwaysShowDecimalSeparator; // CFBoolean
 121 CF_EXPORT const CFStringRef kCFNumberFormatterGroupingSeparator;        // CFString
 122 CF_EXPORT const CFStringRef kCFNumberFormatterUseGroupingSeparator;     // CFBoolean
 123 CF_EXPORT const CFStringRef kCFNumberFormatterPercentSymbol;            // CFString
 124 CF_EXPORT const CFStringRef kCFNumberFormatterZeroSymbol;               // CFString
 125 CF_EXPORT const CFStringRef kCFNumberFormatterNaNSymbol;                // CFString
 126 CF_EXPORT const CFStringRef kCFNumberFormatterInfinitySymbol;           // CFString
 127 CF_EXPORT const CFStringRef kCFNumberFormatterMinusSign;                // CFString
 128 CF_EXPORT const CFStringRef kCFNumberFormatterPlusSign;         // CFString
 129 CF_EXPORT const CFStringRef kCFNumberFormatterCurrencySymbol;           // CFString
 130 CF_EXPORT const CFStringRef kCFNumberFormatterExponentSymbol;           // CFString
 131 CF_EXPORT const CFStringRef kCFNumberFormatterMinIntegerDigits; // CFNumber
 132 CF_EXPORT const CFStringRef kCFNumberFormatterMaxIntegerDigits; // CFNumber
 133 CF_EXPORT const CFStringRef kCFNumberFormatterMinFractionDigits;        // CFNumber
 134 CF_EXPORT const CFStringRef kCFNumberFormatterMaxFractionDigits;        // CFNumber
 135 CF_EXPORT const CFStringRef kCFNumberFormatterGroupingSize;             // CFNumber
 136 CF_EXPORT const CFStringRef kCFNumberFormatterSecondaryGroupingSize;    // CFNumber
 137 CF_EXPORT const CFStringRef kCFNumberFormatterRoundingMode;             // CFNumber
 138 CF_EXPORT const CFStringRef kCFNumberFormatterRoundingIncrement;        // CFNumber
 139 CF_EXPORT const CFStringRef kCFNumberFormatterFormatWidth;              // CFNumber
 140 CF_EXPORT const CFStringRef kCFNumberFormatterPaddingPosition;  // CFNumber
 141 CF_EXPORT const CFStringRef kCFNumberFormatterPaddingCharacter; // CFString
 142 CF_EXPORT const CFStringRef kCFNumberFormatterDefaultFormat;            // CFString
 143 CF_EXPORT const CFStringRef kCFNumberFormatterMultiplier;               // CFNumber
 144 CF_EXPORT const CFStringRef kCFNumberFormatterPositivePrefix;           // CFString
 145 CF_EXPORT const CFStringRef kCFNumberFormatterPositiveSuffix;           // CFString
 146 CF_EXPORT const CFStringRef kCFNumberFormatterNegativePrefix;           // CFString
 147 CF_EXPORT const CFStringRef kCFNumberFormatterNegativeSuffix;           // CFString
 148 CF_EXPORT const CFStringRef kCFNumberFormatterPerMillSymbol;            // CFString
 149 CF_EXPORT const CFStringRef kCFNumberFormatterInternationalCurrencySymbol; // CFString
 150 CF_EXPORT const CFStringRef kCFNumberFormatterCurrencyGroupingSeparator CF_AVAILABLE(10_5, 2_0); // CFString
 151 CF_EXPORT const CFStringRef kCFNumberFormatterIsLenient CF_AVAILABLE(10_5, 2_0);                // CFBoolean
 152 CF_EXPORT const CFStringRef kCFNumberFormatterUseSignificantDigits CF_AVAILABLE(10_5, 2_0);     // CFBoolean
 153 CF_EXPORT const CFStringRef kCFNumberFormatterMinSignificantDigits CF_AVAILABLE(10_5, 2_0);     // CFNumber
 154 CF_EXPORT const CFStringRef kCFNumberFormatterMaxSignificantDigits CF_AVAILABLE(10_5, 2_0);     // CFNumber
 155
 156 typedef CF_ENUM(CFIndex, CFNumberFormatterRoundingMode) {
 157     kCFNumberFormatterRoundCeiling = 0,
 158     kCFNumberFormatterRoundFloor = 1,
 159     kCFNumberFormatterRoundDown = 2,
 160     kCFNumberFormatterRoundUp = 3,
 161     kCFNumberFormatterRoundHalfEven = 4,
 162     kCFNumberFormatterRoundHalfDown = 5,
 163     kCFNumberFormatterRoundHalfUp = 6
 164 };
 165
 166 typedef CF_ENUM(CFIndex, CFNumberFormatterPadPosition) {
 167     kCFNumberFormatterPadBeforePrefix = 0,
 168     kCFNumberFormatterPadAfterPrefix = 1,
 169     kCFNumberFormatterPadBeforeSuffix = 2,
 170     kCFNumberFormatterPadAfterSuffix = 3
 171 };
 172
 173
 174 CF_EXPORT
 175 Boolean CFNumberFormatterGetDecimalInfoForCurrencyCode(CFStringRef currencyCode, int32_t *defaultFractionDigits, double *roundingIncrement);
 176         // Returns the number of fraction digits that should be displayed, and
 177         // the rounding increment (or 0.0 if no rounding is done by the currency)
 178         // for the given currency.  Returns false if the currency code is unknown
 179         // or the information is not available.
 180         // Not localized because these are properties of the currency.
 181
 182 CF_EXTERN_C_END
 183 CF_IMPLICIT_BRIDGING_DISABLED
 184
 185 #endif /* ! __COREFOUNDATION_CFNUMBERFORMATTER__ */
 186