EXPONENT()

Evaluate the exponent of a floating point number

Syntax

      EXPONENT( <nFloatingPointNumber> ) --> nExponent

Arguments

<nFloatingPointNumber> Designate any Harbour number.

Returns

EXPONENT() returns the exponent of the <nFloatingPointNumber> number in base 2.

Description

This function supplements MANTISSA() to return the exponent of the <nFloatingPointNumber> number.

Values > 1 or values < -1 return a positive number 0 to 1023.

Values < 1 or values > -1 return a negative number -1 to -1023.

The EXPONENT( 0 ), return 0.

The following calculation reproduces the original value:

2ˆEXPONENT(<nFloatingPointNumber>) * MANTISSA(<nFloatingPointNumber>) = <nFloatingPointNumber>

TODO: add documentation

Compliance

EXPONENT() is compatible with CT3’s EXPONENT()

Platforms

All

Files

Source is exponent.c, library is libct.

Seealso

MANTISSA()

 MANTISSA()
 Determines the mantissa of a floating point number (base2)
------------------------------------------------------------------------------
 Syntax

     MANTISSA(<nFloatingPointNumber>) --> nMantissa

 Arguments

     <nFloatingPointNumber>  Designates any decimal number.

 Returns

     MANTISSA() returns the mantissa of the <nFloatingPointNumber> number.

 Description

     This function supplements EXPONENT() to return the mantissa of the
     <nFloatingPointNumber> number.

 Notes

     .  The mantissa value can be 0 or in the range of 1 to 2.

     .  The following calculation reproduces the original value:

       MANTISSA(<nFloatingPointNumber>)* 2^EXPONENT(<FloatingPointNumber =
        <nFloatingPointNumber>)

 Example

     Display the mantissa for the following values:

     ? MANTISSA(0)            // Result:  0.00
     ? MANTISSA(100)          // Result:  1.56
     ? MANTISSA(INFINITY)     // Result:  2.00
     ? MANTISSA(0.01)         // Result:  1.28
     ? MANTISSA(-100)         // Result: -1.56
     ? MANTISSA(-0.01)        // Result: -1.28
     ? MANTISSA(-1.01)        // Result: -1.01
     ? MANTISSA(-2.01)        // Result: -1.01

See Also: EXPONENT()