X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=inc%2FFBaseInteger8.h;h=e5cce38a13eed05853a2890d4022ad2a6cd190a2;hb=07a771d39ebf4c7f26a04aeb3e06f9d7eb1c6dc2;hp=c656988595a9aab406cfe10a32efffc690c1c25a;hpb=14883320830aa32ca9936685ca49eeb6b538b0ef;p=platform%2Fframework%2Fnative%2Fappfw.git diff --git a/inc/FBaseInteger8.h b/inc/FBaseInteger8.h index c656988..e5cce38 100644 --- a/inc/FBaseInteger8.h +++ b/inc/FBaseInteger8.h @@ -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 [Deprecated] + * + * @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