Add IPC sync result for SerialPort::Write()
[platform/framework/native/appfw.git] / inc / FBaseShort.h
index 1188008..d97191a 100644 (file)
@@ -203,9 +203,11 @@ public:
         *      @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 decoded value is not between VALUE_MIN and VALUE_MAX range. @b Since: @b 3.0
+        *      @exception      E_OUT_OF_RANGE  The decoded value is not between VALUE_MIN and VALUE_MAX range.
         *
-        *      @remarks        This method accepts decimal, hexadecimal, and octal numbers given by the
+        *      @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
@@ -232,7 +234,7 @@ public:
         *      @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 parsed value is not between VALUE_MIN and VALUE_MAX range. @b Since: @b 3.0
+        *      @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 numeric value uses a radix 10.
@@ -254,22 +256,37 @@ public:
         *      @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 or
-        *                                      The parsed value is not between VALUE_MIN and VALUE_MAX range. @b Since: @b 3.0
+        *                                      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, short& ret);
 
        /**
-        *      Gets the @c signed @c char equivalent of the current instance of the %Short class.
+        *      Gets the @c char equivalent of the current instance of the %Short class.
         *
         *      @since 2.0
+        *      @brief  <i> [Deprecated] </i>
         *
-        *      @return A @c signed @c char equivalent of the current instance
+        *      @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 A @c char equivalent of the current instance
         */
        virtual char ToChar(void) const;
 
        /**
+        *      Gets the @c int8_t equivalent of the current instance of %Short.
+        *
+        *      @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 the %Short class.
         *
         *      @since 2.0
@@ -347,14 +364,14 @@ public:
         *
         *      @since 2.0
         */
-       static const short VALUE_MAX = (short) 0x7FFF;
+       static const short VALUE_MAX = static_cast< short >(0x7FFF);
 
        /**
         *      A constant holding the minimum value a @c short will be equal to -2^15.
         *
         *      @since 2.0
         */
-       static const short VALUE_MIN = (short) 0x8000;
+       static const short VALUE_MIN = static_cast< short >(0x8000);
 
        /**
         * A @c short value of this instance.