Add IPC sync result for SerialPort::Write()
[platform/framework/native/appfw.git] / inc / FBaseInt8.h
index 950347d..5984b97 100644 (file)
@@ -207,8 +207,9 @@ 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.
+        * @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
         *                              following grammar:
         * @code
@@ -241,8 +242,9 @@ 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 byte that can be parsed.
+        * @exception   E_SUCCESS       The method is successful.
+        * @exception   E_NUM_FORMAT    The specified string does not contain a byte that can be parsed.
+        *
         * @remarks
         *                              - This method assumes that the string representing the numeric value uses a radix 10.
         *                              - This method guarantees that the original value of out-parameter is not changed when the method returns error.
@@ -260,27 +262,41 @@ public:
         * @return              The @c signed @c char equivalent of the specified string representing the numeric value using the specified index
         * @param[in]   s       A string representing a numeric value
         * @param[in]   radix   The radix of the string representing a numeric value @n
-        *                                              It must either be 2, 8, 10, or 16.
+        *                      Radix value range is from 2 to 36.
         * @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.
-        * @exception   E_OUT_OF_RANGE The specified @c radix is invalid.
+        * @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 guarantees that the original value of out-parameter is not changed when the method returns error.
         */
        static result Parse(const String& s, int radix, char& ret);
 
        /**
-        * Gets the @c signed @c char equivalent of the current instance of %Int8.
+        * Gets the @c char equivalent of the current instance of %Int8.
         *
         * @since 2.0
         * @brief       <i> [Deprecated] </i>
+        *
         * @deprecated  This class is deprecated because char is treated as unsigned char in ARM architecture. Use Integer8 class.
+        *              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 char equivalent of the current instance
         *
-        * @return      The @c signed @c char equivalent of the current instance
         */
        virtual char ToChar(void) const;
 
        /**
+        * Gets the @c int8_t equivalent of the current instance of %Int8.
+        *
+        * @since 3.0
+        *
+        * @return      The @c int8_t equivalent of the current instance
+        * @remarks     This method always returns 0. Use Integer8::ToInt8() to get the @int8_t
+        */
+       virtual int8_t ToInt8(void) const;
+
+       /**
         * Gets the @c signed @c short equivalent of the current instance of %Int8.
         *
         * @since 2.0
@@ -378,7 +394,7 @@ public:
         * @deprecated  This class is deprecated because char is treated as unsigned char in ARM architecture. Use Integer8 class.
         *
         */
-       static const char VALUE_MAX = (signed char) 0x7F;
+       static const char VALUE_MAX = static_cast< signed char >(0x7F);
 
        /**
         * A constant holding the minimum value of type @c char. @n
@@ -389,7 +405,7 @@ public:
         * @deprecated  This class is deprecated because char is treated as unsigned char in ARM architecture. Use Integer8 class.
         *
         */
-       static const char VALUE_MIN = (signed char) 0x80;
+       static const char VALUE_MIN = static_cast< signed char >(0x80);
 
        /**
         * A @c signed @c char value of this instance.