X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=inc%2FFBaseUtilMath.h;h=0b17e324987721b7c5bc6f591fe68a50c78a1983;hb=72749ddd32dd1e3e2833ada50fad8fceefbdcddc;hp=f8e48e9a5f6fb35f4fd1e69182a97fdbd4dd36d5;hpb=ba579df8b7bd47e2875e4833455443f56683ee01;p=platform%2Fframework%2Fnative%2Fappfw.git diff --git a/inc/FBaseUtilMath.h b/inc/FBaseUtilMath.h index f8e48e9..0b17e32 100644 --- a/inc/FBaseUtilMath.h +++ b/inc/FBaseUtilMath.h @@ -29,7 +29,7 @@ namespace Tizen { namespace Base { namespace Utility { /** * @class Math - * @brief This class is the wrapper class for %Math Library. + * @brief This class is the wrapper class for the %Math Library. * * @since 2.0 * @@ -68,43 +68,43 @@ public: static int Abs(int x); /** - * Gets the arc sine of the specified @c double integer. @n + * Gets the arc sine of the specified @c double integer. @n * Returns a value between @c -PI/2 and @c PI/2. * * @since 2.0 * * @return The arc sine of the input, @n - * else Not-a-Number if @c x is out of range + * else Not-a-Number if @c x is out of the valid range * @param[in] x A radian angle @n - * It must be within the range @c -1 to @c 1 (inclusive). + * It must be within the range @c -1 to @c 1 (inclusive). * @see Acos() * @see Atan() */ static double Asin(double x); /** - * Gets the arc cosine of the specified double integer. @n + * Gets the arc cosine of the specified double integer. @n * Returns a value between @c 0 and @c PI. * * @since 2.0 * * @return The arc cosine of the input, @n - * else Not-a-Number if @c x is out of range + * else Not-a-Number if @c x is out of the valid range * @param[in] x A radian angle @n - * It must be within the range @c -1 to @c 1 (inclusive). + * It must be within the range @c -1 to @c 1 (inclusive). * @see Asin() * @see Atan() */ static double Acos(double x); /** - * Gets the arc tangent of the specified @c double integer. @n + * Gets the arc tangent of the specified @c double integer. @n * Returns a value between @c -PI/2 and @c PI/2. * * @since 2.0 * * @return The arc tangent of the input - * @param[in] x A radian angle + * @param[in] x A radian angle * @see Asin() * @see Acos() */ @@ -118,17 +118,17 @@ public: * @since 2.0 * * @return The smallest integer that is greater than or equal to the input - * @param[in] x A floating point value + * @param[in] x A floating point value */ static double Ceiling(double x); /** - * Gets the cosine of the specified @c double integer. @n + * Gets the cosine of the specified @c double integer. @n * Returns a value between @c -1 and @c 1. * * @since 2.0 * - * @return The cosine of the input + * @return The cosine of the input * @param[in] x A radian angle * @see Sin() * @see Tan() @@ -136,7 +136,7 @@ public: static double Cos(double x); /** - * Gets the hyperbolic cosine of the specified @c double integer. + * Gets the hyperbolic cosine of the specified @c double integer. * * @since 2.0 * @@ -146,12 +146,12 @@ public: static double Cosh(double x); /** - * Gets the exponential value of the specified @c double integer. + * Gets the exponential value of the specified @c double integer. * * @since 2.0 * * @return The exponential value of the input - * @param[in] x A floating point value + * @param[in] x A floating point value */ static double Exp(double x); @@ -163,7 +163,7 @@ public: * @since 2.0 * * @return The largest @c double integer that is less than or equal to the input - * @param[in] x A floating point value + * @param[in] x A floating point value */ static double Floor(double x); @@ -173,7 +173,7 @@ public: * @since 2.0 * * @return The natural logarithm of the input - * @param[in] x A floating point value + * @param[in] x A floating point value */ static double Log(double x); @@ -183,7 +183,7 @@ public: * @since 2.0 * * @return The logarithm to the base 10 of the input - * @param[in] x A floating point value + * @param[in] x A floating point value */ static double Log10(double x); @@ -194,8 +194,8 @@ public: * @since 2.0 * * @return The greater of the two integer values - * @param[in] x An integer value - * @param[in] y An integer value + * @param[in] x An integer value + * @param[in] y An integer value * @see Min() */ static int Max(int x, int y); @@ -208,9 +208,9 @@ public: * @since 2.0 * * @return The greater of the two floating point values - * @param[in] x A floating point value - * @param[in] y A floating point value - * @see Min() + * @param[in] x A floating point value + * @param[in] y A floating point value + * @see Min() */ static double Max(double x, double y); @@ -221,8 +221,8 @@ public: * @since 2.0 * * @return The smaller of the two integer values - * @param[in] x An integer value - * @param[in] y An integer value + * @param[in] x An integer value + * @param[in] y An integer value * @see Max() */ static int Min(int x, int y); @@ -235,8 +235,8 @@ public: * @since 2.0 * * @return The smaller of the two @c double values - * @param[in] x A floating point value - * @param[in] y A floating point value + * @param[in] x A floating point value + * @param[in] y A floating point value * @see Max() */ static double Min(double x, double y); @@ -247,11 +247,12 @@ public: * @since 2.0 * * @return @c x raised to the power of @c y, @n - * else Not-a-Number if @c x and @c y do not satisfy the conditions described below - * @param[in] x A floating point value - * @param[in] y A floating point value - * @remarks @li @c x cannot be negative if @c y is a fractional value. - * @li @c x cannot be @c 0 if @c y is less than or equal to @c 0. + * else Not-a-Number if @c x and @c y do not satisfy the conditions described below + * @param[in] x A floating point value + * @param[in] y A floating point value + * @remarks + * - @li @c x cannot be negative if @c y is a fractional value. + * - @li @c x cannot be @c 0 if @c y is less than or equal to @c 0. */ static double Pow(double x, double y); @@ -261,30 +262,30 @@ public: * @since 2.0 * * @return The closest integer to the specified input - * @param[in] x A floating point value + * @param[in] x A floating point value */ static double Round(double x); /** - * Gets the sine of the specified @c double integer. @n + * Gets the sine of the specified @c double integer. @n * Returns a value between @c -1 and @c 1. * * @since 2.0 * * @return The sine of the input - * @param[in] x A radian angle + * @param[in] x A radian angle * @see Cos() * @see Tan() */ static double Sin(double x); /** - * Gets the hyperbolic sine of the specified @c double integer. + * Gets the hyperbolic sine of the specified @c double integer. * * @since 2.0 * * @return The hyperbolic sine of the input - * @param[in] x A radian angle + * @param[in] x A radian angle */ static double Sinh(double x); @@ -294,18 +295,18 @@ public: * @since 2.0 * * @return The square root of the input, @n - * else Not-a-Number if @c x is a negative number - * @param[in] x A non-negative floating point value + * else Not-a-Number if @c x is a negative number + * @param[in] x A non-negative floating point value */ static double Sqrt(double x); /** - * Gets the tangent of the specified @c double integer. + * Gets the tangent of the specified @c double integer. * * @since 2.0 * * @return The tangent of the input - * @param[in] x A radian angle + * @param[in] x A radian angle * @see Sin() * @see Cos() */ @@ -317,7 +318,7 @@ public: * @since 2.0 * * @return The hyperbolic tangent of the input - * @param[in] x A radian angle + * @param[in] x A radian angle */ static double Tanh(double x); @@ -327,7 +328,7 @@ public: * * @since 2.0 * - * @param[in] seed An integer value to use as seed by the pseudo-random number generator algorithm + * @param[in] seed The integer value used as a seed by the pseudo-random number generator algorithm * @see Rand() */ static void Srand(unsigned int seed); @@ -338,14 +339,14 @@ public: * * @since 2.0 * - * @return An integer value between @c 0 and @c RAND_VALUE_MAX + * @return The integer value between @c 0 and @c RAND_VALUE_MAX * @remarks This method uses a seed to generate the pseudo-random numbers, that must be initialized to some distinctive value using Srand(). * @see Srand() */ static int Rand(void); /** - * Gets the constant value of E (the base of natural logarithms). + * Gets the constant value of E (the base of natural logarithms). * * @since 2.0 * @@ -354,7 +355,7 @@ public: static const double GetE(void); /** - * Gets the constant value of PI. + * Gets the constant value of PI. * * @since 2.0 * @@ -363,10 +364,10 @@ public: static const double GetPi(void); /** - * The maximum value that can be returned by the Rand() method. - * - * @since 2.0 - */ + * The maximum value that can be returned by the Rand() method. + * + * @since 2.0 + */ static const int RAND_VALUE_MAX = 32767; // 0x7fff