Enable build with iniparser v 3.1
[platform/framework/native/appfw.git] / inc / FBaseInteger8.h
index c656988..e5cce38 100644 (file)
@@ -186,9 +186,12 @@ public:
         * @return              An error code
         * @param[in]   s       A string representing a numeric value
         * @param[out]  ret     The result of the operation
-        * @exception   E_SUCCESS        The method is successful.
-        * @exception   E_NUM_FORMAT The specified string does not contain a number that can be parsed.
-        * @remarks             This method accepts decimal, hexadecimal, and octal numbers given by the
+        * @exception   E_SUCCESS       The method is successful.
+        * @exception   E_NUM_FORMAT    The specified string does not contain a number that can be parsed.
+        * @exception   E_OUT_OF_RANGE  The decoded value is not between VALUE_MIN and VALUE_MAX range.
+        * @remarks     
+        *              - This method guarantees that the original value of out-parameter is not changed when the method returns error.
+        *              - This method accepts decimal, hexadecimal, and octal numbers given by the
         *                              following grammar:
         * @code
         *      - DecodableString:
@@ -213,6 +216,7 @@ public:
         * @param[out]  ret     The @c signed 8-bits integral @c int8_t equivalent of the specified string representing the numeric value using the decimal radix.
         * @exception   E_SUCCESS        The method is successful.
         * @exception   E_NUM_FORMAT The specified string does not contain a byte that can be parsed.
+        * @exception   E_OUT_OF_RANGE  The parsed value is not between VALUE_MIN and VALUE_MAX range.
         * @remarks
         *                              - This method assumes that the string representing the @c signed 8-bits integral value uses a radix 10.
         *                              - This method guarantees that the original value of out-parameter is not changed when the method returns error.
@@ -230,24 +234,39 @@ public:
         * @param[in]   radix   The radix of the string representing a numeric value. Radix value range is from 2 to 36.
         * @param[out]  ret     The @c signed 8-bits integral @c int8_t equivalent of the specified string representing the numeric value using the specified radix
         * @exception   E_SUCCESS        The method is successful.
-        * @exception   E_NUM_FORMAT The specified string does not contain a number that can be parsed.
-        * @exception   E_OUT_OF_RANGE The specified @c radix is invalid.
+        * @exception   E_NUM_FORMAT    The specified string does not contain a number that can be parsed.
+        * @exception   E_OUT_OF_RANGE  The specified @c radix is invalid, or
+        *                              The parsed value is not between VALUE_MIN and VALUE_MAX range.
         * @remarks             This method guarantees that the original value of out-parameter is not changed when the method returns error.
         */
        static result Parse(const String& s, int radix, int8_t& ret);
 
        /**
-        * Gets the @c signed @c char equivalent of the current instance of %Integer8.
+        * Gets the @c char equivalent of the current instance of %Integer8.
         *
         * @since 3.0
+        * @brief       <i> [Deprecated] </i>
+        *
+        * @deprecated  This method has portability issue.
+        *              Return value may not be @c signed @c char since char is treated as unsigned char in ARM architecture. @n
+        *              Use ToInt8() method to get @c int8_t
         *
-        * @return      The @c signed @c char equivalent of the current instance
-        * @remarks     This method has portability issue. Return value may not be @c signed @c char since char is treated as unsigned char in ARM architecture. @n
+        * @return      The @c char equivalent of the current instance
         *
         */
        virtual char ToChar(void) const;
 
        /**
+        * Gets the @c int8_t equivalent of the current instance of %Integer8.
+        *
+        * @since 3.0
+        *
+        * @return      The @c int8_t equivalent of the current instance
+        *
+        */
+       virtual int8_t ToInt8(void) const;
+
+       /**
         * Gets the @c signed @c short equivalent of the current instance of %Integer8.
         *
         * @since 3.0