+// © 2016 and later: Unicode, Inc. and others.
+// License & terms of use: http://www.unicode.org/copyright.html
/*
********************************************************************************
-* Copyright (C) 1997-2011, International Business Machines
+* Copyright (C) 1997-2014, International Business Machines
* Corporation and others. All Rights Reserved.
********************************************************************************
*
#define FMTABLE_H
#include "unicode/utypes.h"
-#include "unicode/unistr.h"
-#include "unicode/stringpiece.h"
/**
- * \file
- * \brief C++ API: Formattable is a thin wrapper for primitive numeric types.
+ * \file
+ * \brief C++ API: Formattable is a thin wrapper for primitive types used for formatting and parsing
*/
#if !UCONFIG_NO_FORMATTING
+#include "unicode/unistr.h"
+#include "unicode/stringpiece.h"
+#include "unicode/uformattable.h"
+
+#if U_SHOW_CPLUSPLUS_API
U_NAMESPACE_BEGIN
class CharString;
class DigitList;
+namespace number {
+namespace impl {
+class DecimalQuantity;
+}
+}
+
+/**
+ * \def UNUM_INTERNAL_STACKARRAY_SIZE
+ * @internal
+ */
+#if U_PLATFORM == U_PF_OS400
+#define UNUM_INTERNAL_STACKARRAY_SIZE 144
+#else
+#define UNUM_INTERNAL_STACKARRAY_SIZE 128
+#endif
/**
* Formattable objects can be passed to the Format class or
* within a Formattable.
*
* <p>The Formattable class is not suitable for subclassing.
+ *
+ * <p>See UFormattable for a C wrapper.
*/
class U_I18N_API Formattable : public UObject {
public:
* Creates a Formattable object with a UDate instance.
* @param d the UDate instance.
* @param flag the flag to indicate this is a date. Always set it to kIsDate
- * @stable ICU 2.0
+ * @stable ICU 2.0
*/
Formattable(UDate d, ISDATE flag);
* Creates a Formattable object of an appropriate numeric type from a
* a decimal number in string form. The Formattable will retain the
* full precision of the input in decimal format, even when it exceeds
- * what can be represented by a double of int64_t.
+ * what can be represented by a double or int64_t.
*
* @param number the unformatted (not localized) string representation
* of the Decimal number.
* decimal number.
* @stable ICU 4.4
*/
- Formattable(const StringPiece &number, UErrorCode &status);
+ Formattable(StringPiece number, UErrorCode &status);
/**
* Creates a Formattable object with a UnicodeString object to copy from.
* @stable ICU 2.0
*/
UBool operator==(const Formattable &other) const;
-
- /**
+
+ /**
* Equality operator.
* @param other the object to be compared with.
* @return TRUE if other are unequal to this, FALSE otherwise.
UBool operator!=(const Formattable& other) const
{ return !operator==(other); }
- /**
+ /**
* Destructor.
* @stable ICU 2.0
*/
*/
Formattable *clone() const;
- /**
+ /**
* Selector for flavor of data type contained within a
* Formattable object. Formattable is a union of several
* different types, and at any time contains exactly one type.
* @stable ICU 2.0
*/
Type getType(void) const;
-
+
/**
* Returns TRUE if the data type of this Formattable object
- * is kDouble, kLong, kInt64 or kDecimalNumber.
+ * is kDouble, kLong, or kInt64
* @return TRUE if this is a pure numeric object
* @stable ICU 3.0
*/
UBool isNumeric() const;
-
+
/**
* Gets the double value of this object. If this object is not of type
* kDouble then the result is undefined.
* @return the double value of this object.
* @stable ICU 2.0
- */
+ */
double getDouble(void) const { return fValue.fDouble; }
/**
* @param status the error code
* @return the double value of this object.
* @stable ICU 3.0
- */
+ */
double getDouble(UErrorCode& status) const;
/**
* kLong then the result is undefined.
* @return the long value of this object.
* @stable ICU 2.0
- */
+ */
int32_t getLong(void) const { return (int32_t)fValue.fInt64; }
/**
* as appropriate, is returned and the status is set to
* U_INVALID_FORMAT_ERROR. If this object is of type kInt64 and
* it fits within a long, then no precision is lost. If it is of
- * type kDouble or kDecimalNumber, then a conversion is peformed, with
+ * type kDouble, then a conversion is peformed, with
* truncation of any fractional part. If the type is kObject and
* the object is a Measure, then the result of
* getNumber().getLong(status) is returned. If this object is
* @param status the error code
* @return the long value of this object.
* @stable ICU 3.0
- */
+ */
int32_t getLong(UErrorCode& status) const;
/**
* kInt64 then the result is undefined.
* @return the int64 value of this object.
* @stable ICU 2.8
- */
+ */
int64_t getInt64(void) const { return fValue.fInt64; }
/**
* @param status the error code
* @return the int64 value of this object.
* @stable ICU 3.0
- */
+ */
int64_t getInt64(UErrorCode& status) const;
/**
* kDate then the result is undefined.
* @return the Date value of this object.
* @stable ICU 2.0
- */
+ */
UDate getDate() const { return fValue.fDate; }
/**
* @param status the error code.
* @return the Date value of this object.
* @stable ICU 3.0
- */
+ */
UDate getDate(UErrorCode& status) const;
/**
* @param result Output param to receive the Date value of this object.
* @return A reference to 'result'.
* @stable ICU 2.0
- */
+ */
UnicodeString& getString(UnicodeString& result) const
{ result=*fValue.fString; return result; }
* string, status is set to U_INVALID_FORMAT_ERROR and a bogus
* string is returned.
* @param result Output param to receive the Date value of this object.
- * @param status the error code.
+ * @param status the error code.
* @return A reference to 'result'.
* @stable ICU 3.0
- */
+ */
UnicodeString& getString(UnicodeString& result, UErrorCode& status) const;
/**
* Gets a reference to the string value of this object. If the
* type is not a string, status is set to U_INVALID_FORMAT_ERROR
* and the result is a bogus string.
- * @param status the error code.
+ * @param status the error code.
* @return a reference to the string value of this object.
* @stable ICU 3.0
*/
* @param count fill-in with the count of this object.
* @return the array value of this object.
* @stable ICU 2.0
- */
+ */
const Formattable* getArray(int32_t& count) const
{ count=fValue.fArrayAndCount.fCount; return fValue.fArrayAndCount.fArray; }
* not an array, status is set to U_INVALID_FORMAT_ERROR, count is
* set to 0, and the result is NULL.
* @param count fill-in with the count of this object.
- * @param status the error code.
+ * @param status the error code.
* @return the array value of this object.
* @stable ICU 3.0
- */
+ */
const Formattable* getArray(int32_t& count, UErrorCode& status) const;
/**
* @stable ICU 2.0
*/
Formattable& operator[](int32_t index) { return fValue.fArrayAndCount.fArray[index]; }
-
+
/**
* Returns a pointer to the UObject contained within this
* formattable, or NULL if this object does not contain a UObject.
* For values obtained by parsing, the returned decimal number retains
* the full precision and range of the original input, unconstrained by
* the limits of a double floating point or a 64 bit int.
- *
+ *
* This function is not thread safe, and therfore is not declared const,
* even though it is logically const.
*
* kDouble.
* @param d the new double value to be set.
* @stable ICU 2.0
- */
+ */
void setDouble(double d);
/**
* kLong.
* @param l the new long value to be set.
* @stable ICU 2.0
- */
+ */
void setLong(int32_t l);
/**
* kInt64.
* @param ll the new int64 value to be set.
* @stable ICU 2.8
- */
+ */
void setInt64(int64_t ll);
/**
* kDate.
* @param d the new Date value to be set.
* @stable ICU 2.0
- */
+ */
void setDate(UDate d);
/**
* kString.
* @param stringToCopy the new string value to be set.
* @stable ICU 2.0
- */
+ */
void setString(const UnicodeString& stringToCopy);
/**
* @param array the array value.
* @param count the number of array elements to be copied.
* @stable ICU 2.0
- */
+ */
void setArray(const Formattable* array, int32_t count);
/**
* changes the type to kArray.
* @param stringToAdopt the new string value to be adopted.
* @stable ICU 2.0
- */
+ */
void adoptString(UnicodeString* stringToAdopt);
/**
* Sets and adopts the array value and count of this object and
* changes the type to kArray.
* @stable ICU 2.0
- */
+ */
void adoptArray(Formattable* array, int32_t count);
-
+
/**
* Sets and adopts the UObject value of this object and changes
* the type to kObject. After this call, the caller must not
/**
* Sets the the numeric value from a decimal number string, and changes
- * the type to to a numeric type appropriate for the number.
+ * the type to to a numeric type appropriate for the number.
* The syntax of the number is a "numeric string"
* as defined in the Decimal Arithmetic Specification, available at
* http://speleotrove.com/decimal
* incoming string is not a valid decimal number.
* @stable ICU 4.4
*/
- void setDecimalNumber(const StringPiece &numberString,
+ void setDecimalNumber(StringPiece numberString,
UErrorCode &status);
/**
*/
static UClassID U_EXPORT2 getStaticClassID();
+ /**
+ * Convert the UFormattable to a Formattable. Internally, this is a reinterpret_cast.
+ * @param fmt a valid UFormattable
+ * @return the UFormattable as a Formattable object pointer. This is an alias to the original
+ * UFormattable, and so is only valid while the original argument remains in scope.
+ * @stable ICU 52
+ */
+ static inline Formattable *fromUFormattable(UFormattable *fmt);
+
+ /**
+ * Convert the const UFormattable to a const Formattable. Internally, this is a reinterpret_cast.
+ * @param fmt a valid UFormattable
+ * @return the UFormattable as a Formattable object pointer. This is an alias to the original
+ * UFormattable, and so is only valid while the original argument remains in scope.
+ * @stable ICU 52
+ */
+ static inline const Formattable *fromUFormattable(const UFormattable *fmt);
+
+ /**
+ * Convert this object pointer to a UFormattable.
+ * @return this object as a UFormattable pointer. This is an alias to this object,
+ * and so is only valid while this object remains in scope.
+ * @stable ICU 52
+ */
+ inline UFormattable *toUFormattable();
+
+ /**
+ * Convert this object pointer to a UFormattable.
+ * @return this object as a UFormattable pointer. This is an alias to this object,
+ * and so is only valid while this object remains in scope.
+ * @stable ICU 52
+ */
+ inline const UFormattable *toUFormattable() const;
+
#ifndef U_HIDE_DEPRECATED_API
/**
* Deprecated variant of getLong(UErrorCode&).
* @param status the error code
* @return the long value of this object.
* @deprecated ICU 3.0 use getLong(UErrorCode&) instead
- */
+ */
inline int32_t getLong(UErrorCode* status) const;
#endif /* U_HIDE_DEPRECATED_API */
*/
DigitList *getDigitList() const { return fDecimalNum;}
+ /**
+ * @internal
+ */
+ DigitList *getInternalDigitList();
+
+ /**
+ * Internal function, do not use.
+ * TODO: figure out how to make this be non-public.
+ * NumberFormat::format(Formattable, ...
+ * needs to get at the DecimalQuantity, if it exists, for
+ * big decimal formatting.
+ * @internal
+ */
+ number::impl::DecimalQuantity *getDecimalQuantity() const { return fDecimalQuantity;}
+
+ /**
+ * Export the value of this Formattable to a DecimalQuantity.
+ * @internal
+ */
+ void populateDecimalQuantity(number::impl::DecimalQuantity& output, UErrorCode& status) const;
+
/**
* Adopt, and set value from, a DigitList
* Internal Function, do not use.
* @internal
*/
void adoptDigitList(DigitList *dl);
+
+ /**
+ * Adopt, and set value from, a DecimalQuantity
+ * Internal Function, do not use.
+ * @param dl the DecimalQuantity to be adopted
+ * @internal
+ */
+ void adoptDecimalQuantity(number::impl::DecimalQuantity *dq);
+
+ /**
+ * Internal function to return the CharString pointer.
+ * @param status error code
+ * @return pointer to the CharString - may become invalid if the object is modified
+ * @internal
+ */
+ CharString *internalGetCharString(UErrorCode &status);
+
#endif /* U_HIDE_INTERNAL_API */
private:
} fValue;
CharString *fDecimalStr;
+
DigitList *fDecimalNum;
+ char fStackData[UNUM_INTERNAL_STACKARRAY_SIZE]; // must be big enough for DigitList
+
+ number::impl::DecimalQuantity *fDecimalQuantity;
+
Type fType;
UnicodeString fBogus; // Bogus string when it's needed.
};
inline int32_t Formattable::getLong(UErrorCode* status) const {
return getLong(*status);
}
-#endif
+#endif /* U_HIDE_DEPRECATED_API */
+
+inline UFormattable* Formattable::toUFormattable() {
+ return reinterpret_cast<UFormattable*>(this);
+}
+inline const UFormattable* Formattable::toUFormattable() const {
+ return reinterpret_cast<const UFormattable*>(this);
+}
+
+inline Formattable* Formattable::fromUFormattable(UFormattable *fmt) {
+ return reinterpret_cast<Formattable *>(fmt);
+}
+
+inline const Formattable* Formattable::fromUFormattable(const UFormattable *fmt) {
+ return reinterpret_cast<const Formattable *>(fmt);
+}
U_NAMESPACE_END
+#endif // U_SHOW_CPLUSPLUS_API
#endif /* #if !UCONFIG_NO_FORMATTING */
projects / apple / icu.git / blobdiff