home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / c++ / cplxexp.z / cplxexp
Encoding:
Text File  |  1998-10-30  |  5.8 KB  |  67 lines
  1.  
  2.  
  3.  
  4. CCCCPPPPLLLLXXXXEEEEXXXXPPPP((((3333CCCC++++++++))))                                                    CCCCPPPPLLLLXXXXEEEEXXXXPPPP((((3333CCCC++++++++))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      exp, log, pow, sqrt - exponential, logarithm, power, square root
  10.      functions for the C++ complex library
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_cccc_oooo_mmmm_pppp_llll_eeee_xxxx_...._hhhh_>>>>
  14.  
  15.      _cccc_llll_aaaa_ssss_ssss _cccc_oooo_mmmm_pppp_llll_eeee_xxxx _{{{{
  16.  
  17.      _pppp_uuuu_bbbb_llll_iiii_cccc_::::
  18.                _ffff_rrrr_iiii_eeee_nnnn_dddd _cccc_oooo_mmmm_pppp_llll_eeee_xxxx _eeee_xxxx_pppp_((((_cccc_oooo_mmmm_pppp_llll_eeee_xxxx_))))_;;;;
  19.                _ffff_rrrr_iiii_eeee_nnnn_dddd _cccc_oooo_mmmm_pppp_llll_eeee_xxxx _llll_oooo_gggg_((((_cccc_oooo_mmmm_pppp_llll_eeee_xxxx_))))_;;;;
  20.                _ffff_rrrr_iiii_eeee_nnnn_dddd _cccc_oooo_mmmm_pppp_llll_eeee_xxxx _pppp_oooo_wwww_((((_dddd_oooo_uuuu_bbbb_llll_eeee_,,,, _cccc_oooo_mmmm_pppp_llll_eeee_xxxx_))))_;;;;
  21.                _ffff_rrrr_iiii_eeee_nnnn_dddd _cccc_oooo_mmmm_pppp_llll_eeee_xxxx _pppp_oooo_wwww_((((_cccc_oooo_mmmm_pppp_llll_eeee_xxxx_,,,, _iiii_nnnn_tttt_))))_;;;;
  22.                _ffff_rrrr_iiii_eeee_nnnn_dddd _cccc_oooo_mmmm_pppp_llll_eeee_xxxx _pppp_oooo_wwww_((((_cccc_oooo_mmmm_pppp_llll_eeee_xxxx_,,,, _dddd_oooo_uuuu_bbbb_llll_eeee_))))_;;;;
  23.                _ffff_rrrr_iiii_eeee_nnnn_dddd _cccc_oooo_mmmm_pppp_llll_eeee_xxxx _pppp_oooo_wwww_((((_cccc_oooo_mmmm_pppp_llll_eeee_xxxx_,,,, _cccc_oooo_mmmm_pppp_llll_eeee_xxxx_))))_;;;;
  24.                _ffff_rrrr_iiii_eeee_nnnn_dddd _cccc_oooo_mmmm_pppp_llll_eeee_xxxx _ssss_qqqq_rrrr_tttt_((((_cccc_oooo_mmmm_pppp_llll_eeee_xxxx_))))_;;;;
  25.      _}}}}_;;;;
  26.  
  27. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  28.      The following math functions are overloaded by the complex library,
  29.      where:
  30.       - _x, _y, and _z are of type _cccc_oooo_mmmm_pppp_llll_eeee_xxxx.
  31.  
  32.      _z _==== _eeee_xxxx_pppp_((((_x_))))     Returns _e_x.
  33.  
  34.      _z _==== _llll_oooo_gggg_((((_x_))))     Returns the natural logarithm of _x.
  35.  
  36.      _z _==== _pppp_oooo_wwww_((((_x_,,,, _y_))))  Returns _x_y.
  37.  
  38.      _z _==== _ssss_qqqq_rrrr_tttt_((((_x_))))    Returns the square root of _x, contained in the first or
  39.                     fourth quadrants of the complex plane.
  40.  
  41. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  42.      _cccc_oooo_mmmm_pppp_llll_eeee_xxxx(3C++), _cccc_aaaa_rrrr_tttt_pppp_oooo_llll(3C++), _cccc_pppp_llll_xxxx_eeee_rrrr_rrrr(3C++), _cccc_pppp_llll_xxxx_oooo_pppp_ssss(3C++), and
  43.      _cccc_pppp_llll_xxxx_tttt_rrrr_iiii_gggg(3C++).
  44.  
  45. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  46.      _eeee_xxxx_pppp returns _((((_0000_,,,, _0000_)))) when the real part of _x is so small, or the imaginary
  47.      part is so large, as to cause overflow.  When the real part is large
  48.      enough to cause overflow, _eeee_xxxx_pppp returns _((((_HHHH_UUUU_GGGG_EEEE_,,,, _HHHH_UUUU_GGGG_EEEE_)))) if the cosine and sine
  49.      of the imaginary part of _x are positive, _((((_HHHH_UUUU_GGGG_EEEE_,,,, _----_HHHH_UUUU_GGGG_EEEE_)))) if the cosine is
  50.      positive and the sine is not, _((((_----_HHHH_UUUU_GGGG_EEEE_,,,, _HHHH_UUUU_GGGG_EEEE_)))) if the sine is positive and
  51.      the cosine is not, and _((((_----_HHHH_UUUU_GGGG_EEEE_,,,, _----_HHHH_UUUU_GGGG_EEEE_)))) if neither sine nor cosine is
  52.      positive.  In all these cases, _e_r_r_n_o is set to _EEEE_RRRR_AAAA_NNNN_GGGG_EEEE.
  53.  
  54.      _llll_oooo_gggg returns _((((_----_HHHH_UUUU_GGGG_EEEE_,,,, _0000_)))) and sets _e_r_r_n_o to _EEEE_DDDD_OOOO_MMMM when _x is _((((_0000_,,,, _0000_)))).  A
  55.      message indicating _SSSS_IIII_NNNN_GGGG error is printed on the standard error output.
  56.  
  57.      These error-handling procedures may be changed with the function
  58.      _cccc_oooo_mmmm_pppp_llll_eeee_xxxx______eeee_rrrr_rrrr_oooo_rrrr (_cccc_pppp_llll_xxxx_eeee_rrrr_rrrr(3C++)).
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.