diff options
Diffstat (limited to 'Doc/lib')
| -rw-r--r-- | Doc/lib/libfuncs.tex | 18 | ||||
| -rw-r--r-- | Doc/lib/libstring.tex | 14 |
2 files changed, 20 insertions, 12 deletions
diff --git a/Doc/lib/libfuncs.tex b/Doc/lib/libfuncs.tex index 316b294..210fec4 100644 --- a/Doc/lib/libfuncs.tex +++ b/Doc/lib/libfuncs.tex @@ -231,13 +231,17 @@ removed. \begin{funcdesc}{float}{x} Convert a string or a number to floating point. If the argument is a string, it must contain a possibly signed decimal or floating point - number, possibly embedded in whitespace, or be \code{'NaN'} (case - insensitive); this behaves identical to - \code{string.atof(\var{x})}. If the string is \code{'NaN'}, the - IEEE ``Not a Number'' value is returned. Otherwise, the argument - may be a plain or long integer or a floating point number, and a - floating point number with the same value (within Python's floating - point precision) is returned. + number, possibly embedded in whitespace; this behaves identical to + \code{string.atof(\var{x})}. Otherwise, the argument may be a plain + or long integer or a floating point number, and a floating point + number with the same value (within Python's floating point + precision) is returned. + + \strong{Note:} When passing in a string, values for NaN\index{NaN} + and Infinity\index{Infinity} may be returned, depending on the + underlying C library. The specific set of strings accepted which + cause these values to be returned depends entirely on the C library + and is known to vary. \end{funcdesc} \begin{funcdesc}{getattr}{object, name} diff --git a/Doc/lib/libstring.tex b/Doc/lib/libstring.tex index 56dcf6d..a83d821 100644 --- a/Doc/lib/libstring.tex +++ b/Doc/lib/libstring.tex @@ -59,11 +59,15 @@ The functions defined in this module are: \begin{funcdesc}{atof}{s} Convert a string to a floating point number. The string must have the standard syntax for a floating point literal in Python, - optionally preceded by a sign (\samp{+} or \samp{-}), or be - \code{'NaN'} (case insensitive) to indicate the IEEE ``Not a - Number'' value. Note that this behaves identical to the built-in - function \function{float()}\bifuncindex{float} when passed a - string. + optionally preceded by a sign (\samp{+} or \samp{-}). Note that + this behaves identical to the built-in function + \function{float()}\bifuncindex{float} when passed a string. + + \strong{Note:} When passing in a string, values for NaN\index{NaN} + and Infinity\index{Infinity} may be returned, depending on the + underlying C library. The specific set of strings accepted which + cause these values to be returned depends entirely on the C library + and is known to vary. \end{funcdesc} \begin{funcdesc}{atoi}{s\optional{, base}} |