home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _f1c3b493a172b26529644b20825cb327 < prev    next >
Text File  |  2000-03-23  |  4KB  |  122 lines
  1.  
  2. <HTML>
  3. <HEAD>
  4. <TITLE>Math::BigFloat - Arbitrary length float math package</TITLE>
  5. <LINK REL="stylesheet" HREF="../../Active.css" TYPE="text/css">
  6. <LINK REV="made" HREF="mailto:">
  7. </HEAD>
  8.  
  9. <BODY>
  10. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  11. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  12. <STRONG><P CLASS=block> Math::BigFloat - Arbitrary length float math package</P></STRONG>
  13. </TD></TR>
  14. </TABLE>
  15.  
  16. <A NAME="__index__"></A>
  17. <!-- INDEX BEGIN -->
  18.  
  19. <UL>
  20.  
  21.     <LI><A HREF="#name">NAME</A></LI><LI><A HREF="#supportedplatforms">SUPPORTED PLATFORMS</A></LI>
  22.  
  23.     <LI><A HREF="#synopsis">SYNOPSIS</A></LI>
  24.     <LI><A HREF="#description">DESCRIPTION</A></LI>
  25.     <LI><A HREF="#bugs">BUGS</A></LI>
  26.     <LI><A HREF="#author">AUTHOR</A></LI>
  27. </UL>
  28. <!-- INDEX END -->
  29.  
  30. <HR>
  31. <P>
  32. <H1><A NAME="name">NAME</A></H1>
  33. <P>Math::BigFloat - Arbitrary length float math package</P>
  34. <P>
  35. <HR>
  36. <H1><A NAME="supportedplatforms">SUPPORTED PLATFORMS</A></H1>
  37. <UL>
  38. <LI>Linux</LI>
  39. <LI>Solaris</LI>
  40. <LI>Windows</LI>
  41. </UL>
  42. <HR>
  43. <H1><A NAME="synopsis">SYNOPSIS</A></H1>
  44. <PRE>
  45.   use Math::BigFloat;
  46.   $f = Math::BigFloat->new($string);</PRE>
  47. <PRE>
  48.   $f->fadd(NSTR) return NSTR            addition
  49.   $f->fsub(NSTR) return NSTR            subtraction
  50.   $f->fmul(NSTR) return NSTR            multiplication
  51.   $f->fdiv(NSTR[,SCALE]) returns NSTR   division to SCALE places
  52.   $f->fneg() return NSTR                negation
  53.   $f->fabs() return NSTR                absolute value
  54.   $f->fcmp(NSTR) return CODE            compare undef,<0,=0,>0
  55.   $f->fround(SCALE) return NSTR         round to SCALE digits
  56.   $f->ffround(SCALE) return NSTR        round at SCALEth place
  57.   $f->fnorm() return (NSTR)             normalize
  58.   $f->fsqrt([SCALE]) return NSTR        sqrt to SCALE places</PRE>
  59. <P>
  60. <HR>
  61. <H1><A NAME="description">DESCRIPTION</A></H1>
  62. <P>All basic math operations are overloaded if you declare your big
  63. floats as</P>
  64. <PRE>
  65.     $float = new Math::BigFloat "2.123123123123123123123123123123123";</PRE>
  66. <DL>
  67. <DT><STRONG><A NAME="item_number_format">number format</A></STRONG><BR>
  68. <DD>
  69. canonical strings have the form /[+-]\d+E[+-]\d+/ .  Input values can
  70. have embedded whitespace.
  71. <P></P>
  72. <DT><STRONG><A NAME="item_Error_returns_%27NaN%27">Error returns 'NaN'</A></STRONG><BR>
  73. <DD>
  74. An input parameter was ``Not a Number'' or divide by zero or sqrt of
  75. negative number.
  76. <P></P>
  77. <DT><STRONG><A NAME="item_Division_is_computed_to">Division is computed to</A></STRONG><BR>
  78. <DD>
  79. <CODE>max($Math::BigFloat::div_scale,length(dividend)+length(divisor))</CODE>
  80. digits by default.
  81. Also used for default sqrt scale.
  82. <P></P>
  83. <DT><STRONG><A NAME="item_Rounding_is_performed">Rounding is performed</A></STRONG><BR>
  84. <DD>
  85. according to the value of
  86. <CODE>$Math::BigFloat::rnd_mode</CODE>:
  87. <PRE>
  88.   trunc     truncate the value
  89.   zero      round towards 0
  90.   +inf      round towards +infinity (round up)
  91.   -inf      round towards -infinity (round down)
  92.   even      round to the nearest, .5 to the even digit
  93.   odd       round to the nearest, .5 to the odd digit</PRE>
  94. <P>The default is <CODE>even</CODE> rounding.</P>
  95. <P></P></DL>
  96. <P>
  97. <HR>
  98. <H1><A NAME="bugs">BUGS</A></H1>
  99. <P>The current version of this module is a preliminary version of the
  100. real thing that is currently (as of perl5.002) under development.</P>
  101. <P>The printf subroutine does not use the value of
  102. <CODE>$Math::BigFloat::rnd_mode</CODE> when rounding values for printing.
  103. Consequently, the way to print rounded values is
  104. to specify the number of digits both as an
  105. argument to <CODE>ffround</CODE> and in the <CODE>%f</CODE> printf string,
  106. as follows:</P>
  107. <PRE>
  108.   printf "%.3f\n", $bigfloat->ffround(-3);</PRE>
  109. <P>
  110. <HR>
  111. <H1><A NAME="author">AUTHOR</A></H1>
  112. <P>Mark Biggar</P>
  113. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  114. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  115. <STRONG><P CLASS=block> Math::BigFloat - Arbitrary length float math package</P></STRONG>
  116. </TD></TR>
  117. </TABLE>
  118.  
  119. </BODY>
  120.  
  121. </HTML>
  122.