Browse Source

Document tonumber() enhancements.

Mike Pall 12 years ago
parent
commit
4e7fe815ed
1 changed files with 12 additions and 1 deletions
  1. 12 1
      doc/extensions.html

+ 12 - 1
doc/extensions.html

@@ -170,6 +170,17 @@ positive infinity results in <tt>"inf"</tt> and negative infinity results
 in <tt>"-inf"</tt>.
 in <tt>"-inf"</tt>.
 </p>
 </p>
 
 
+<h3 id="tonumber"><tt>tonumber()</tt> etc. use builtin string to number conversion</h3>
+<p>
+All string-to-number conversions consistently convert integer and
+floating-point inputs in decimal and hexadecimal on all platforms.
+<tt>strtod()</tt> is <em>not</em> used anymore, which avoids numerous
+problems with poor C library implementations. The builtin conversion
+function provides full precision according to the IEEE-754 standard, it
+works independently of the current locale and it supports hex floating-point
+numbers (e.g. <tt>0x1.5p-3</tt>).
+</p>
+
 <h3 id="string_dump"><tt>string.dump(f [,strip])</tt> generates portable bytecode</h3>
 <h3 id="string_dump"><tt>string.dump(f [,strip])</tt> generates portable bytecode</h3>
 <p>
 <p>
 An extra argument has been added to <tt>string.dump()</tt>. If set to
 An extra argument has been added to <tt>string.dump()</tt>. If set to
@@ -198,7 +209,7 @@ implementation which uses the platform-specific ANSI rand().
 The PRNG generates the same sequences from the same seeds on all
 The PRNG generates the same sequences from the same seeds on all
 platforms and makes use of all bits in the seed argument.
 platforms and makes use of all bits in the seed argument.
 <tt>math.random()</tt> without arguments generates 52 pseudo-random bits
 <tt>math.random()</tt> without arguments generates 52 pseudo-random bits
-for every call. The result is uniformly distributed between 0 and 1.
+for every call. The result is uniformly distributed between 0.0 and 1.0.
 It's correctly scaled up and rounded for <tt>math.random(n&nbsp;[,m])</tt> to
 It's correctly scaled up and rounded for <tt>math.random(n&nbsp;[,m])</tt> to
 preserve uniformity.
 preserve uniformity.
 </p>
 </p>