home *** CD-ROM | disk | FTP | other *** search
/ Amiga Developer CD v1.2 / amidev_cd_12.iso / inc&ad2.0 / text_autodocs / mathieeesingbas.doc < prev    next >
Text File  |  1992-09-01  |  7KB  |  326 lines
  1. TABLE OF CONTENTS
  2.  
  3. mathieeesingbas.library/IEEESPAbs
  4. mathieeesingbas.library/IEEESPAdd
  5. mathieeesingbas.library/IEEESPCeil
  6. mathieeesingbas.library/IEEESPCmp
  7. mathieeesingbas.library/IEEESPDiv
  8. mathieeesingbas.library/IEEESPFix
  9. mathieeesingbas.library/IEEESPFloor
  10. mathieeesingbas.library/IEEESPFlt
  11. mathieeesingbas.library/IEEESPMul
  12. mathieeesingbas.library/IEEESPNeg
  13. mathieeesingbas.library/IEEESPSub
  14. mathieeesingbas.library/IEEESPTst
  15. mathieeesingbas.library/IEEESPAbs           mathieeesingbas.library/IEEESPAbs
  16.  
  17.    NAME
  18.     IEEESPAbs -- compute absolute value of IEEE single precision argument
  19.  
  20.    SYNOPSIS
  21.       x   = IEEESPAbs(  y  );
  22.      d0            d0
  23.  
  24.     float    x,y;
  25.  
  26.    FUNCTION
  27.     Take the absolute value of argument y and return it to caller.
  28.  
  29.    INPUTS
  30.     y -- IEEE single precision floating point value
  31.  
  32.    RESULT
  33.     x -- IEEE single precision floating point value
  34.  
  35.    BUGS
  36.  
  37.    SEE ALSO
  38. mathieeesingbas.library/IEEESPAdd           mathieeesingbas.library/IEEESPAdd
  39.  
  40.    NAME
  41.     IEEESPAdd -- add one single precision IEEE number to another
  42.  
  43.    SYNOPSIS
  44.       x   = IEEESPAdd(  y  ,  z  );
  45.      d0           d0     d1
  46.  
  47.     float    x,y,z;
  48.  
  49.    FUNCTION
  50.     Compute x = y + z in IEEE single precision.
  51.  
  52.    INPUTS
  53.     y -- IEEE single precision floating point value
  54.     z -- IEEE single precision floating point value
  55.  
  56.    RESULT
  57.     x -- IEEE single precision floating point value
  58.  
  59.    BUGS
  60.  
  61.    SEE ALSO
  62.     IEEESPSub
  63. mathieeesingbas.library/IEEESPCeil         mathieeesingbas.library/IEEESPCeil
  64.  
  65.    NAME
  66.     IEEESPCeil -- compute Ceil function of IEEE single precision number
  67.  
  68.    SYNOPSIS
  69.       x   = IEEESPCeil(  y  );
  70.      d0             d0
  71.  
  72.     float    x,y;
  73.  
  74.    FUNCTION
  75.     Calculate the least integer greater than or equal to x and return it.
  76.     This identity is true.  Ceil(x) = -Floor(-x).
  77.  
  78.    INPUTS
  79.     y -- IEEE single precision floating point value
  80.  
  81.    RESULT
  82.     x -- IEEE single precision floating point value
  83.  
  84.    BUGS
  85.  
  86.    SEE ALSO
  87.     IEEESPFloor
  88. mathieeesingbas.library/IEEESPCmp           mathieeesingbas.library/IEEESPCmp
  89.  
  90.    NAME
  91.     IEEESPCmp -- compare two single precision floating point numbers
  92.  
  93.    SYNOPSIS
  94.       c   = IEEESPCmp(  y  ,  z  );
  95.       d0            d0   d1
  96.  
  97.     float    y,z;
  98.     long    c;
  99.  
  100.    FUNCTION
  101.     Compare y with z. Set the condition codes for less, greater, or
  102.     equal. Set return value c to -1 if y<z, or +1 if y>z, or 0 if
  103.     y == z.
  104.  
  105.    INPUTS
  106.     y -- IEEE single precision floating point value
  107.     z -- IEEE single precision floating point value
  108.  
  109.    RESULT
  110.        c = 1   cc = gt         for (y > z)
  111.        c = 0   cc = eq         for (y == z)
  112.        c = -1  cc = lt         for (y < z)
  113.  
  114.    BUGS
  115.  
  116.    SEE ALSO
  117. mathieeesingbas.library/IEEESPDiv           mathieeesingbas.library/IEEESPDiv
  118.  
  119.    NAME
  120.     IEEESPDiv -- divide one single precision IEEE by another
  121.  
  122.    SYNOPSIS
  123.       x   = IEEESPDiv(  y  ,  z  );
  124.      d0           d0    d1
  125.  
  126.     float    x,y,z;
  127.  
  128.    FUNCTION
  129.     Compute x = y / z in IEEE single precision.
  130.     Note that the Motorola fast floating point Div routine reverses
  131.     the order of the arguments for the C interface, although the
  132.     dividend is still in d0 and the divisor is in d1.
  133.  
  134.    INPUTS
  135.     y -- IEEE single precision floating point value
  136.     z -- IEEE single precision floating point value
  137.  
  138.    RESULT
  139.     x -- IEEE single precision floating point value
  140.  
  141.    BUGS
  142.  
  143.    SEE ALSO
  144.     IEEESPMul
  145. mathieeesingbas.library/IEEESPFix           mathieeesingbas.library/IEEESPFix
  146.  
  147.    NAME
  148.     IEEESPFix -- convert IEEE single float to integer
  149.  
  150.    SYNOPSIS
  151.     x   = IEEESPFix(  y  );
  152.     d0         d0
  153.  
  154.     long    x;
  155.     float    y;
  156.  
  157.    FUNCTION
  158.     Convert IEEE single precision argument to a 32 bit signed integer
  159.     and return result.
  160.  
  161.    INPUTS
  162.     y -- IEEE single precision floating point value
  163.  
  164.    RESULT
  165.     if no overflow occured then return
  166.         x -- 32 bit signed integer
  167.     if overflow return largest +- integer
  168.         For round to zero
  169.  
  170.    BUGS
  171.  
  172.    SEE ALSO
  173.     IEEESPFlt
  174. mathieeesingbas.library/IEEESPFloor       mathieeesingbas.library/IEEESPFloor
  175.  
  176.    NAME
  177.     IEEESPFloor -- compute Floor function of IEEE single precision number
  178.  
  179.    SYNOPSIS
  180.       x   = IEEESPFloor(  y  );
  181.       d0              d0
  182.  
  183.     float    x,y;
  184.  
  185.    FUNCTION
  186.     Calculate the largest integer less than or equal to x and return it.
  187.  
  188.    INPUTS
  189.     y -- IEEE single precision floating point value
  190.  
  191.    RESULT
  192.     x -- IEEE single precision floating point value
  193.  
  194.    BUGS
  195.  
  196.    SEE ALSO
  197.     IEEESPCeil
  198. mathieeesingbas.library/IEEESPFlt           mathieeesingbas.library/IEEESPFlt
  199.  
  200.    NAME
  201.     IEEESPFlt -- convert integer to IEEE single precision number
  202.  
  203.    SYNOPSIS
  204.       x   = IEEESPFlt(  y  );
  205.      d0           d0
  206.  
  207.     float    x;
  208.     long    y;
  209.  
  210.    FUNCTION
  211.     Convert a signed 32 bit value to a single precision IEEE value
  212.     and return it in d0. No exceptions can occur with this
  213.     function.
  214.  
  215.    INPUTS
  216.     y -- 32 bit integer in d0
  217.  
  218.    RESULT
  219.     x is a 32 bit single precision IEEE value
  220.  
  221.    BUGS
  222.  
  223.    SEE ALSO
  224.     IEEESPFix
  225. mathieeesingbas.library/IEEESPMul           mathieeesingbas.library/IEEESPMul
  226.  
  227.    NAME
  228.     IEEESPMul -- multiply one double precision IEEE number by another
  229.  
  230.    SYNOPSIS
  231.       x   = IEEESPMul(  y  ,  z  );
  232.      d0           d0    d1
  233.  
  234.     float    x,y,z;
  235.  
  236.    FUNCTION
  237.     Compute x = y * z in IEEE single precision.
  238.  
  239.    INPUTS
  240.     y -- IEEE single precision floating point value
  241.     z -- IEEE single precision floating point value
  242.  
  243.    RESULT
  244.     x -- IEEE single precision floating point value
  245.  
  246.    BUGS
  247.  
  248.    SEE ALSO
  249.     IEEESPDiv
  250. mathieeesingbas.library/IEEESPNeg           mathieeesingbas.library/IEEESPNeg
  251.  
  252.    NAME
  253.     IEEESPNeg -- compute negative value of IEEE single precision number
  254.  
  255.    SYNOPSIS
  256.       x   = IEEESPNeg(  y  );
  257.       d0           d0
  258.  
  259.     float    x,y;
  260.  
  261.    FUNCTION
  262.     Invert the sign of argument y and return it to caller.
  263.  
  264.    INPUTS
  265.     y - IEEE single precision floating point value
  266.  
  267.    RESULT
  268.     x - IEEE single precision floating point value
  269.  
  270.    BUGS
  271.  
  272.    SEE ALSO
  273. mathieeesingbas.library/IEEESPSub           mathieeesingbas.library/IEEESPSub
  274.  
  275.    NAME
  276.     IEEESPSub -- subtract one single precision IEEE number from another
  277.  
  278.    SYNOPSIS
  279.       x   = IEEESPSub(  y  ,  z  );
  280.      d0           d0     d1
  281.  
  282.     float    x,y,z;
  283.  
  284.    FUNCTION
  285.     Compute x = y - z in IEEE single precision.
  286.  
  287.    INPUTS
  288.     y -- IEEE single precision floating point value
  289.     z -- IEEE single precision floating point value
  290.  
  291.    RESULT
  292.     x -- IEEE single precision floating point value
  293.  
  294.    BUGS
  295.  
  296.    SEE ALSO
  297.     IEEESPAdd
  298. mathieeesingbas.library/IEEESPTst           mathieeesingbas.library/IEEESPTst
  299.  
  300.    NAME
  301.     IEEESPTst -- compare IEEE single precision value to 0.0
  302.  
  303.    SYNOPSIS
  304.       c   = IEEESPTst(  y  );
  305.       d0            d0
  306.  
  307.     float    y;
  308.     long    c;
  309.  
  310.    FUNCTION
  311.     Compare y to 0.0, set the condition codes for less than, greater
  312.     than, or equal to 0.0.  Set the return value c to -1 if less than,
  313.     to +1 if greater than, or 0 if equal to 0.0.
  314.  
  315.    INPUTS
  316.     y -- IEEE single precision floating point value
  317.  
  318.    RESULT
  319.     c = 1    cc = gt        for (y > 0.0)
  320.     c = 0    cc = eq        for (y == 0.0)
  321.     c = -1  cc = lt        for (y < 0.0)
  322.  
  323.    BUGS
  324.  
  325.    SEE ALSO
  326.