United States-English |
|
|
HP-UX Reference > Aannuity(3M)HP Integrity Server OnlyHP-UX 11i Version 3: February 2007 |
|
NAMEannuity(), annuityf(), annuityl(), annuityw(), annuityq() — present value factor for annuity SYNOPSIS#include <math.h> double annuity(double rate, double periods); float annuityf(float rate, float periods); long double annuityl(long double rate, long double periods); extended annuityw(extended rate, extended periods); quad annuityq(quad rate, quad periods); DESCRIPTIONThe annuity() function computes the present value factor for an annuity: (1 - (1 + rate) ** (-periods)) / rate annuityf() is a float version of annuity(); it takes float arguments and returns a float result. annuityl() is a long double version of annuity(); it takes long double arguments and returns a long double result. annuityw() is an extended version of annuity(); it takes extended arguments and returns an extended result. annuityq() is equivalent to annuityl() on HP-UX systems. USAGETo use these functions, compile either with the default -Ae option or with the -Aa and -D_HPUX_SOURCE options. To use annuityw()or annuityq(), compile with the -fpwidetypes option. Make sure your program includes <math.h>. Link in the math library by specifying -lm on the compiler or linker command line. RETURN VALUEIf periods equals zero, annuity() returns 0.0. Else, if rate equals zero, annuity() returns periods. Else, if either argument is a NaN, annuity() returns a NaN. Else, if rate < -1, annuity() returns a NaN and raises the invalid exception. Else, if rate = -1 and periods = +INFINITY, annuity() returns +INFINITY. Else, if rate equals -1 and periods > 0, annuity() is equivalent to 1.0 / 0.0. Else, if rate equals -1, annuity() returns -1. Else, if rate equals +INFINITY and periods >= 0, annuity() returns +0.0. Else, if rate equals +INFINITY and -1 < periods < 0, annuity() returns -0.0. Else, if rate equals +INFINITY and periods = -1, annuity() returns -1. Else, if rate equals +INFINITY, annuity() returns -INFINITY. Else, if periods is infinite and (rate * periods) > 0, annuity() is equivalent to 1.0 / rate. Else, if periods is infinite, annuity() returns periods. annuity() returns a properly signed infinity in lieu of a value whose magnitude is too large, and raises the overflow and inexact exceptions. annuity() raises the underflow and inexact exceptions whenever a result is tiny (essentially denormal or zero) and thereby suffers loss of accuracy, and may raise those exceptions if the result is merely tiny. |
Printable version | ||
|