»
Symbian OS v9.3 »
Symbian OS reference »
C++ component reference »
Base E32_EKA2 »
Math
Location:
e32math.h
Link against: euser.lib
class Math;
Description
A collection of mathematical functions.
Members
Defined in Math
:
ACos()
, ASin()
, ATan()
, ATan()
, Cos()
, DivMod64()
, DtoR()
, Exp()
, FRand()
, Frac()
, Int()
, Int()
, Int()
, IsFinite()
, IsInfinite()
, IsNaN()
, IsZero()
, Ln()
, Log()
, Mod()
, Mul64()
, Poly()
, PolyX()
, Pow()
, Pow10()
, Rand()
, Random()
, Round()
, Sin()
, Sqrt()
, Tan()
, UDivMod64()
, UMul64()
Member functions
static IMPORT_C TInt ACos(TReal &aTrg, const TReal &aSrc);
Description
Calculates the principal value of the inverse cosine of a number.
Parameters
TReal &aTrg |
A reference containing the result in radians, a value between 0 and pi.
|
const TReal &aSrc |
The argument of the arccos function, a value between -1 and +1 inclusive.
|
|
Return value
TInt
|
KErrNone if successful, otherwise another of the system-wide error codes.
|
|
static IMPORT_C TInt ASin(TReal &aTrg, const TReal &aSrc);
Description
Calculates the principal value of the inverse sine of a number.
Parameters
TReal &aTrg |
A reference containing the result in radians, a value between -pi/2 and +pi/2.
|
const TReal &aSrc |
The argument of the arcsin function, a value between -1 and +1 inclusive.
|
|
Return value
TInt
|
KErrNone if successful, otherwise another of the system-wide error codes.
|
|
static IMPORT_C TInt ATan(TReal &aTrg, const TReal &aSrc);
Description
Calculates the principal value of the inverse tangent of a number.
Parameters
TReal &aTrg |
A reference containing the result in radians, a value between -pi/2 and +pi/2.
|
const TReal &aSrc |
The argument of the arctan function, a value between +infinity and +infinity.
|
|
Return value
TInt
|
KErrNone if successful, otherwise another of the system-wide error codes.
|
|
static IMPORT_C TInt ATan(TReal &aTrg, const TReal &aSrcY, const TReal &aSrcX);
Description
Calculates the angle between the x-axis and a line drawn from the origin to a point represented by its (x,y) co-ordinates.
The co-ordinates are passed as arguments to the function. This function returns the same result as arctan(y/x), but:
1. it adds +/-pi to the result, if x is negative
2. it sets the result to +/-pi/2, if x is zero but y is non-zero.
Parameters
TReal &aTrg |
A reference containing the result in radians, a value between -pi exclusive and +pi inclusive.
|
const TReal &aSrcY |
The y argument of the arctan(y/x) function.
|
const TReal &aSrcX |
The x argument of the arctan(y/x) function.
|
|
Return value
TInt
|
KErrNone if successful, otherwise another of the system-wide error codes.
|
|
static IMPORT_C TInt Cos(TReal &aTrg, const TReal &aSrc);
Description
Calculates the cosine of a number.
Parameters
TReal &aTrg |
A reference containing the result.
|
const TReal &aSrc |
The argument of the cos function in radians
|
|
Return value
TInt
|
KErrNone if successful, otherwise another of the system-wide error codes.
|
|
static IMPORT_C TInt DtoR(TReal &aTrg, const TDesC &aSrc, TInt &aPos, const TChar aPoint);
Description
This function is not implemented by Symbian OS.
Parameters
Return value
static IMPORT_C TInt Exp(TReal &aTrg, const TReal &aSrc);
Description
Calculates the value of e to the power of x.
Parameters
TReal &aTrg |
A reference containing the result.
|
const TReal &aSrc |
The power to which e is to be raised.
|
|
Return value
TInt
|
KErrNone if successful, otherwise another of the system-wide error codes.
|
|
static IMPORT_C TInt Frac(TReal &aTrg, const TReal &aSrc);
Description
Calculates the fractional part of a number.
The fractional part is that after a decimal point. Truncation is toward zero, so that Frac(2.4)=0.4, Frac(2)=0, Frac(-1)=0,
Frac(-1.4)=0.4.
Parameters
TReal &aTrg |
A reference containing the result.
|
const TReal &aSrc |
The number whose fractional part is required.
|
|
Return value
TInt
|
KErrNone if successful, otherwise another of the system-wide error codes.
|
|
static IMPORT_C TInt Int(TReal &aTrg, const TReal &aSrc);
Description
Calculates the integer part of a number.
The integer part is that before a decimal point. Truncation is toward zero, so that int(2.4)=2, int(2)=2, int(-1)=-1, int(-1.4)=-1,
int(-1.999)=-1.
Parameters
TReal &aTrg |
A reference containing the result.
|
const TReal &aSrc |
The number whose integer part is required.
|
|
Return value
TInt
|
KErrNone if successful, otherwise another of the system-wide error codes.
|
|
static IMPORT_C TInt Int(TInt16 &aTrg, const TReal &aSrc);
Description
Calculates the integer part of a number.
The integer part is that before a decimal point. Truncation is toward zero, so that int(2.4)=2, int(2)=2, int(-1)=-1, int(-1.4)=-1,
int(-1.999)=-1.
This function is suitable when the result is known to be small enough for a 16-bit signed integer.
Parameters
TInt16 &aTrg |
A reference containing the result.
|
const TReal &aSrc |
The number whose integer part is required.
|
|
Return value
TInt
|
KErrNone if successful, otherwise another of the system-wide error codes.
|
|
static IMPORT_C TInt Int(TInt32 &aTrg, const TReal &aSrc);
Description
Calculates the integer part of a number.
The integer part is that before a decimal point. Truncation is toward zero, so that int(2.4)=2, int(2)=2, int(-1)=-1, int(-1.4)=-1,
int(-1.999)=-1.
This function is suitable when the result is known to be small enough for a 32-bit signed integer.
Parameters
TInt32 &aTrg |
A reference containing the result.
|
const TReal &aSrc |
The number whose integer part is required.
|
|
Return value
TInt
|
KErrNone if successful, otherwise another of the system-wide error codes.
|
|
static IMPORT_C TInt Log(TReal &aTrg, const TReal &aSrc);
Description
Calculates the logarithm to base 10 of a number.
Parameters
TReal &aTrg |
A reference containing the result.
|
const TReal &aSrc |
The number whose logarithm is required.
|
|
Return value
TInt
|
KErrNone if successful, otherwise another of the system-wide error codes.
|
|
static IMPORT_C TInt Ln(TReal &aTrg, const TReal &aSrc);
Description
Calculates the natural logarithm of a number.
Parameters
TReal &aTrg |
A reference containing the result.
|
const TReal &aSrc |
The number whose natural logarithm is required.
|
|
Return value
TInt
|
KErrNone if successful, otherwise another of the system-wide error codes.
|
|
static IMPORT_C TInt Mod(TReal &aTrg, const TReal &aSrc, const TReal &aModulus);
Description
Calculates the modulo remainder.
This is the value of p mod q, the modulo remainder when dividing p by q. The result is given by p - q int (p/q): it has the
same sign as p: thus, 5 mod 3 = 2, -5 mod 3 = -2. No error is raised if non-integer arguments are passed.
Parameters
TReal &aTrg |
A reference containing the result.
|
const TReal &aSrc |
The p argument to the mod function.
|
const TReal &aModulus |
The q argument to the mod function.
|
|
Return value
TInt
|
KErrNone if successful, otherwise another of the system-wide error codes.
|
|
static IMPORT_C TReal Poly(TReal aVal, const SPoly *aPoly);
Description
Evaluates the polynomial: {a[n]X^n + a[n-1]X^(n-1) + ... + a[2]X^2 + a[1]X^1 + a[0]}.
Parameters
TReal aVal |
The value of the x-variable
|
const SPoly *aPoly |
A pointer to the structure containing the set of coefficients in the order: a[0], a[1], ..., a[n-1], a[n].
|
|
Return value
TReal
|
The result of the evaluation.
|
|
static IMPORT_C TInt Pow(TReal &aTrg, const TReal &aSrc, const TReal &aPower);
Description
Calculates the value of y to the power of x.
Parameters
TReal &aTrg |
A reference containing the result.
|
const TReal &aSrc |
The y argument of the function.
|
const TReal &aPower |
The x argument of the function.
|
|
Return value
TInt
|
KErrNone if successful, otherwise another of the system-wide error codes.
|
|
static IMPORT_C TInt Pow10(TReal &aTrg, const TInt exp);
Description
Calculates the value of 10 to the power of x.
Parameters
TReal &aTrg |
A reference containing the result.
|
const TInt exp |
The power to which 10 is to be raised.
|
|
Return value
TInt
|
KErrNone if successful, otherwise another of the system-wide error codes.
|
|
static IMPORT_C TInt Rand(TInt64 &aSeed);
Description
Generates a stream of uniformly distributed pseudo-random integers in the range, 0 to KMaxTInt.
For each stream of pseudo-random numbers you wish to generate, you should pass the reference to the same 64-bit seed on each
call to this function. You should not change the seed between calls.
Parameters
TInt64 &aSeed |
A reference to a 64-bit seed, which is updated as a result of the call.
|
|
Return value
TInt
|
The next pseudo-random number in the sequence.
|
|
static IMPORT_C TReal FRand(TInt64 &aSeed);
Description
Generates a stream of uniformly distributed pseudo-random real numbers in the range, 0 to 1.
Parameters
TInt64 &aSeed |
A reference to a 64-bit seed, which is updated as a result of the call.
|
|
Return value
TReal
|
The next pseudo-random number in the sequence.
|
|
static IMPORT_C TUint32 Random();
Description
Gets 32 random bits from the kernel's random pool.
Return value
static IMPORT_C TInt Round(TReal &aTrg, const TReal &aSrc, TInt aDecimalPlaces);
Description
Rounds to a specified number of decimal places.
The function rounds a number to a given number, n, of decimal places. Rounding may be thought of as multiplying the number
by 10 to the power of n, rounding to the nearest integer, and then dividing the result by 10 to the power of n and returning
that as the answer.
In the process of rounding, numbers ending with .5 are rounded away from zero, so that 1.5 becomes 2, 2.5 becomes 3, -1.5
becomes -2, etc.
Parameters
TReal &aTrg |
A reference containing the result.
|
const TReal &aSrc |
The number to be rounded.
|
TInt aDecimalPlaces |
The number of decimal places to round to: must be zero or positive.
|
|
Return value
TInt
|
KErrNone if successful, otherwise another of the system-wide error codes.
|
|
static IMPORT_C TInt Sin(TReal &aTrg, const TReal &aSrc);
Description
Calculates the sine of a number.
Parameters
TReal &aTrg |
A reference containing the result.
|
const TReal &aSrc |
The argument of the sin function in radians.
|
|
Return value
TInt
|
KErrNone if successful, otherwise another of the system-wide error codes.
|
|
static IMPORT_C TInt Sqrt(TReal &aTrg, const TReal &aSrc);
Description
Calculates the square root of a number.
Parameters
TReal &aTrg |
A reference containing the result.
|
const TReal &aSrc |
The number whose square-root is required.
|
|
Return value
TInt
|
KErrNone if successful, otherwise another of the system-wide error codes.
|
|
static IMPORT_C TInt Tan(TReal &aTrg, const TReal &aSrc);
Description
Calculates the tangent of a number.
Parameters
TReal &aTrg |
A reference containing the result.
|
const TReal &aSrc |
The argument of the tan function in radians.
|
|
Return value
TInt
|
KErrNone if successful, otherwise another of the system-wide error codes.
|
|
static IMPORT_C TBool IsZero(const TReal &aVal);
Description
Determines whether a value is zero.
Parameters
const TReal &aVal |
A reference to the value to be checked.
|
|
Return value
TBool
|
True, if aVal is zero; false, otherwise.
|
|
static IMPORT_C TBool IsNaN(const TReal &aVal);
Description
Determines whether a value is not a number.
Parameters
const TReal &aVal |
A reference to the value to be checked.
|
|
Return value
TBool
|
True, if aVal is not a number; false, otherwise.
|
|
static IMPORT_C TBool IsInfinite(const TReal &aVal);
Description
Determines whether a value is infinite.
Parameters
const TReal &aVal |
A reference to the value to be checked.
|
|
Return value
TBool
|
True, if aVal is infinite; false, otherwise.
|
|
static IMPORT_C TBool IsFinite(const TReal &aVal);
Description
Determines whether a value is finite.
In this context, a value is finite if it is a valid number and is not infinite.
Parameters
const TReal &aVal |
A reference to the value to be checked.
|
|
Return value
TBool
|
True, if aVal is finite; false, otherwise.
|
|
static IMPORT_C void PolyX(TRealX &aY, const TRealX &aX, TInt aDeg, const TRealX *aCoef);
Description
Evaluates the polynomial: {a[n]X^n + a[n-1]X^(n-1) + ... + a[2]X^2 + a[1]X^1 + a[0]}.
Parameters
TRealX &aY |
A reference containing the result.
|
const TRealX &aX |
The value of the x-variable.
|
TInt aDeg |
The degree of the polynomial (the highest power of x which is present).
|
const TRealX *aCoef |
A pointer to a contiguous set of TRealX values containing the coefficients. They must be in the order: a[0], a[1], ..., a[n-1], a[n].
|
|
static IMPORT_C void Mul64(Int64 aX, Int64 aY, Int64 &aOutH, Uint64 &aOutL);
Description
Multiply aX by aY to generate a 128 bit result.
The high order 64 bits of this calculation are stored in aOutH, and the low order 64 bits are stored in aOutL.
Parameters
Int64 aX |
The first 64-bit operand.
|
Int64 aY |
The second 64-bit operand.
|
Int64 &aOutH |
The high order 64 bits of the result.
|
Uint64 &aOutL |
The low order 64 bits of the result.
|
|
static IMPORT_C void UMul64(Uint64 aX, Uint64 aY, Uint64 &aOutH, Uint64 &aOutL);
Description
Multiply aX by aY to generate a 128 bit result.
The high order 64 bits of this calculation are stored in aOutH, and the low order 64 bits are stored in aOutL.
Parameters
Uint64 aX |
The first 64-bit operand.
|
Uint64 aY |
The second 64-bit operand.
|
Uint64 &aOutH |
The high order 64 bits of the result.
|
Uint64 &aOutL |
The low order 64 bits of the result.
|
|
static IMPORT_C Int64 DivMod64(Int64 aDividend, Int64 aDivisor, Int64 &aRemainder);
Description
Divides aDividend by aDivisor.
The quotient is returned, and the remainder is stored in aRemainder. The remainder has same sign as the dividend.
Parameters
Int64 aDividend |
The 64-bit dividend.
|
Int64 aDivisor |
The 64-bit divisor.
|
Int64 &aRemainder |
The 64-bit remainder.
|
|
Return value
Int64 |
The 64-bit quotient.
|
|
static IMPORT_C Uint64 UDivMod64(Uint64 aDividend, Uint64 aDivisor, Uint64 &aRemainder);
Description
Divides aDividend by aDivisor.
The quotient is returned, and the remainder is stored in aRemainder.
Parameters
Uint64 aDividend |
The 64-bit dividend.
|
Uint64 aDivisor |
The 64-bit divisor.
|
Uint64 &aRemainder |
The 64-bit remainder.
|
|
Return value
Uint64 |
The 64-bit quotient.
|
|