[ACR][20/08/2013][Add]Enhance Double::ToString() andFloat::ToString() to set a specif...

Change-Id: Ie46eaacfba3475a5920c362f50c7de6457004567
Signed-off-by: darpan.ka <darpan.ka@samsung.com>

diff --git a/inc/FBaseDouble.h b/inc/FBaseDouble.h
index a636438..b4e49c2 100644 (file)
--- a/inc/FBaseDouble.h
+++ b/inc/FBaseDouble.h
@@ -210,7 +210,7 @@ public:
        static result Parse(const String& s, double& ret);
 
        /**
-        * Gets the @c signed @c char equivalent of the current instance of %Double.
+        * Gets the @c signed @c char equivalent of the current %Double instance.
         *
         * @since 2.0
         *
@@ -219,7 +219,7 @@ public:
        virtual char ToChar(void) const;
 
        /**
-        * Gets the @c signed @c short equivalent of the current instance of %Double.
+        * Gets the @c signed @c short equivalent of the current %Double instance.
         *
         * @since 2.0
         *
@@ -228,7 +228,7 @@ public:
        virtual short ToShort(void) const;
 
        /**
-        * Gets the @c signed @c int equivalent of the current instance of %Double.
+        * Gets the @c signed @c int equivalent of the current %Double instance.
         *
         * @since 2.0
         *
@@ -237,7 +237,7 @@ public:
        virtual int ToInt(void) const;
 
        /**
-        * Gets the @c signed @c long equivalent of the current instance of %Double.
+        * Gets the @c signed @c long equivalent of the current %Double instance.
         *
         * @since 2.0
         *
@@ -246,7 +246,7 @@ public:
        virtual long ToLong(void) const;
 
        /**
-        * Gets the @c signed @c long @c long equivalent of the current instance of %Double.
+        * Gets the @c signed @c long @c long equivalent of the current %Double instance.
         *
         * @since 2.0
         *
@@ -255,7 +255,7 @@ public:
        virtual long long ToLongLong(void) const;
 
        /**
-        * Gets the @c signed @c float equivalent of the current instance of %Double.
+        * Gets the @c signed @c float equivalent of the current %Double instance.
         *
         * @since 2.0
         *
@@ -264,7 +264,7 @@ public:
        virtual float ToFloat(void) const;
 
        /**
-        * Gets the @c signed @c double equivalent of the current instance of %Double.
+        * Gets the @c signed @c double equivalent of the current %Double instance.
         *
         * @since 2.0
         *
@@ -273,20 +273,45 @@ public:
        virtual double ToDouble(void) const;
 
        /**
-        * Gets the string representing the value of the current instance of %Double.
+        * Gets the string representing the value of the current %Double instance.
         *
         * @since 2.0
         *
-        * @return              A string containing a Unicode representation of the value of the current instance
+        * @return              A string containing a Unicode representation of the current instance value.
         * @remarks
         *                              - If the value of the current instance is Not-a-Number (NaN), the result is the string "NaN". Furthermore, infinity
         *                              produces the result "Infinity". @n
-        *                              6 digits are given for the precision of this method. Use String::Format() to set the specific precision.
+        *                              6 digits are given for the precision of this method. Use Double::ToString(int precision) to set the specific precision.
         *                              - The behavior of this method is dependent on the system default locale setting.
         */
        virtual String ToString(void) const;
 
        /**
+        * Gets the string representing the value of the current %Double instance.
+        *
+        * @since 3.0
+        *
+        * @param[in]   precision       Number of digits after a decimal separator
+        * @return              A string containing a Unicode representation of the current instance value
+        * @remarks
+        *                              - If the value of the current instance is Not-a-Number (NaN), the result is the string "NaN". Furthermore, infinity
+        *                              produces the result "Infinity". @n
+        *                              - The behavior of this method is dependent on the system default locale setting.
+        *
+        * @code
+        *
+        *      Double dbl(3.1416);
+        *      String str1 = dbl.ToString(3);
+        *      // str1 contains "3.142"
+        *
+        *      String str2 = dbl.ToString(2);
+        *      // str2 contains "3.14"
+        *
+        * @endcode
+        */
+       virtual String ToString(int precision) const;
+
+       /**
         * Gets the string representing the specified @c double value.
         *
         * @since 2.0
@@ -296,18 +321,43 @@ public:
         * @remarks
         *                              - If the input value is Not-a-Number (NaN), the result is the string "NaN". Furthermore, infinity
         *                              produces the result "Infinity". @n
-        *                              6 digits are given for the precision of this method. Use String::Format() to set the specific precision.
+        *                              6 digits are given for the precision of this method. Use Double::ToString(float value, int precision) to set the specific precision.
         *                              - The behavior of this method is dependent on the system default locale setting.
         */
        static String ToString(double value);
 
        /**
+        * Gets the string representing the specified @c double value.
+        *
+        * @since 3.0
+        *
+        * @return              A string containing a Unicode representation of the specified @c double value
+        * @param[in]   value   A @c double value to convert
+        * @param[in]   precision       Number of digits after a decimal separator
+        * @remarks
+        *                              - If the input value is Not-a-Number (NaN), the result is the string "NaN". Furthermore, infinity
+        *                              produces the result "Infinity". @n
+        *                              - The behavior of this method is dependent on the system default locale setting.
+        *
+        * @code
+        *
+        *      String str1 = Double::ToString(3.1416f, 3);
+        *      // str1 contains "3.142"
+        *
+        *      String str2 = Double::ToString(3.1416f, 2);
+        *      // str2 contains "3.14"
+        *
+        * @endcode
+        */
+       static String ToString(double value, int precision);
+
+       /**
         * Gets the IEEE 754 floating-point "double format" bit layout representation of the specified @c double value.
         *
         * @since 2.0
         *
         * @return              The bits that represent the floating-point number in the IEEE 754 floating-point "double format" bit layout
-        * @param[in]   value   A @c double value to convert
+        * @param[in]   value   A @c double value to convert
         */
        static long long ToBits(double value);
 
@@ -409,4 +459,4 @@ private:
 
 }; // Double
 }} // Tizen::Base
-#endif //_FBASE_DOUBLE_H_
\ No newline at end of file
+#endif //_FBASE_DOUBLE_H_

diff --git a/inc/FBaseFloat.h b/inc/FBaseFloat.h
index b10d4e0..82b7abb 100644 (file)
--- a/inc/FBaseFloat.h
+++ b/inc/FBaseFloat.h
@@ -27,6 +27,7 @@
 
 #include <FBaseNumber.h>
 
+
 namespace Tizen { namespace Base
 {
 /**
@@ -200,7 +201,7 @@ public:
        static result Parse(const String& s, float& ret);
 
        /**
-        *      Gets the @c signed @c char equivalent of the current instance of the %Float class.
+        *      Gets the @c signed @c char equivalent of the current %Float instance.
         *
         *      @since          2.0
         *
@@ -209,7 +210,7 @@ public:
        virtual char ToChar(void) const;
 
        /**
-        *      Gets the @c signed @c short equivalent of the current instance of the %Float class.
+        *      Gets the @c signed @c short equivalent of the current %Float instance.
         *
         *      @since          2.0
         *
@@ -218,7 +219,7 @@ public:
        virtual short ToShort(void) const;
 
        /**
-        *      Gets the @c signed @c int equivalent of the current instance of the %Float class.
+        *      Gets the @c signed @c int equivalent of the current %Float instance.
         *
         *      @since          2.0
         *
@@ -227,7 +228,7 @@ public:
        virtual int ToInt(void) const;
 
        /**
-        *      Gets the @c signed @c long equivalent of the current instance of the %Float class.
+        *      Gets the @c signed @c long equivalent of the current %Float instance.
         *
         *      @since          2.0
         *
@@ -236,7 +237,7 @@ public:
        virtual long ToLong(void) const;
 
        /**
-        * Gets the @c signed @c long @c long equivalent of the current instance of the %Float class.
+        * Gets the @c signed @c long @c long equivalent of the current %Float instance.
         *
         * @since               2.0
         *
@@ -245,7 +246,7 @@ public:
        virtual long long ToLongLong(void) const;
 
        /**
-        *      Gets the @c signed @c float equivalent of the current instance of the %Float class.
+        *      Gets the @c signed @c float equivalent of the current %Float instance.
         *
         *      @since          2.0
         *
@@ -254,7 +255,7 @@ public:
        virtual float ToFloat(void) const;
 
        /**
-        *      Gets the @c signed @c double equivalent of the current instance of the %Float class.
+        *      Gets the @c signed @c double equivalent of the current %Float instance.
         *
         *      @since          2.0
         *
@@ -263,20 +264,45 @@ public:
        virtual double ToDouble(void) const;
 
        /**
-        * Gets the string representing the value of the current instance of %Float.
+        * Gets the string representing the value of the current %Float instance.
         *
         * @since                       2.0
         *
-        * @return              A string containing a Unicode representation of the value of the current instance
+        * @return              A string containing a Unicode representation of the value of the current instance value
         * @remarks
         *                              - If the value is Not-a-Number (NaN), the result is the string "NaN". Furthermore, infinity
         *                              produces the result "Infinity". @n
-        *                              6 digits are given for the precision of this method. Use String::Format() to set the specific precision.
+        *                              6 digits are given for the precision of this method. Use Float::ToString(int precision) to set the specific precision.
         *                              - The behavior of this method is dependent on the system default locale setting.
         */
        virtual String ToString(void) const;
 
        /**
+        * Gets the string representing the value of the current %Float instance.
+        *
+        * @since 3.0
+        *
+        * @param[in]   precision       Number of digits after a decimal separator
+        * @return              A string containing a Unicode representation of the value of the current instance value
+        * @remarks
+        *                              - If the value of the current instance is Not-a-Number (NaN), the result is the string "NaN". Furthermore, infinity
+        *                              produces the result "Infinity". @n
+        *                              - The behavior of this method is dependent on the system default locale setting.
+         *
+        * @code
+        *
+        *      Float flt(3.1416);
+        *      String str1 = flt.ToString(3);
+        *      // str1 contains "3.142"
+        *
+        *      String str2 = flt.ToString(2);
+        *      // str2 contains "3.14"
+        *
+        * @endcode
+        */
+       virtual String ToString(int precision) const;
+
+       /**
         *      Gets the string representing the specified @c float value.
         *
         *      @since          2.0
@@ -286,12 +312,38 @@ public:
         *  @remarks
         *                              - If the value is Not-a-Number (NaN), the result is the string "NaN". Furthermore, infinity
         *                              produces the result "Infinity". @n
-        *                              6 digits are given for the precision of this method. Use String::Format() to set the specific precision.
+        *                              6 digits are given for the precision of this method. Use Float::ToString(float value, int precision) to set the specific precision.
         *                              - The behavior of this method is dependent on the system default locale setting.
         */
        static String ToString(float value);
 
        /**
+        * Gets the string representing the specified @c float value.
+        *
+        * @since               3.0
+        *
+        * @return              A string containing a Unicode representation of the specified @c float value
+        * @param[in]   value   A @c float value to convert
+        * @param[in]   precision       Number of digits after a decimal separator
+        * @remarks
+        *                              - If the value is Not-a-Number (NaN), the result is the string "NaN". Furthermore, infinity
+        *                              produces the result "Infinity". @n
+        *                              - The behavior of this method is dependent on the system default locale setting.
+        *
+        * @code
+        *
+        *      String str1 = Float::ToString(3.1416f, 3);
+        *      // str1 contains "3.142"
+        *
+        *      String str2 = Float::ToString(3.1416f, 2);
+        *      // str2 contains "3.14"
+        *
+        * @endcode
+        */
+       static String ToString(float value, int precision);
+
+
+       /**
         *      Gets the IEEE 754 floating-point "single format" bit layout representation of the specified @c float value.
         *
         *      @since          2.0

diff --git a/src/base/FBaseDouble.cpp b/src/base/FBaseDouble.cpp
index 8aebf82..55c1bf2 100644 (file)
--- a/src/base/FBaseDouble.cpp
+++ b/src/base/FBaseDouble.cpp
@@ -209,11 +209,26 @@ Double::ToString(void) const
 }
 
 String
+Double::ToString(int precision) const
+{
+//Dummy implementation to resolve build break
+       return String(L"");
+}
+
+String
 Double::ToString(double value)
 {
        return _LocalizedNumParser::ToString(value, "");
 }
 
+String
+Double::ToString(double value, int precision)
+{
+//Dummy implementation to resolve build break
+       return String(L"");
+}
+
+
 long long
 Double::ToBits(double value)
 {

diff --git a/src/base/FBaseFloat.cpp b/src/base/FBaseFloat.cpp
index 800af2e..7f24ae7 100644 (file)
--- a/src/base/FBaseFloat.cpp
+++ b/src/base/FBaseFloat.cpp
@@ -203,11 +203,26 @@ Float::ToString(void) const
 }
 
 String
+Float::ToString(int precision) const
+{
+//Dummy implementation to resolve build break
+       return String(L"");
+}
+
+String
 Float::ToString(float value)
 {
        return _LocalizedNumParser::ToString(value, "");
 }
 
+String
+Float::ToString(float value, int precision)
+{
+//Dummy implementation to resolve build break
+       return String(L"");
+}
+
+
 int
 Float::ToBits(float value)
 {