diff options
| author | Georg Brandl <georg@python.org> | 2007-09-24 17:59:28 (GMT) |
|---|---|---|
| committer | Georg Brandl <georg@python.org> | 2007-09-24 17:59:28 (GMT) |
| commit | e4186252b1134eb629bff347aa4c4c5630f0df36 (patch) | |
| tree | 1d7fbcf2fbfa5897121bc3ddc71cfb448ddf7af7 /Doc/library/functions.rst | |
| parent | 97ca58370a50b1cae1a56f68d4d9705522d3275f (diff) | |
| download | cpython-e4186252b1134eb629bff347aa4c4c5630f0df36.zip cpython-e4186252b1134eb629bff347aa4c4c5630f0df36.tar.gz cpython-e4186252b1134eb629bff347aa4c4c5630f0df36.tar.bz2 | |
#1196: document default radix for int().
Diffstat (limited to 'Doc/library/functions.rst')
| -rw-r--r-- | Doc/library/functions.rst | 23 |
1 files changed, 12 insertions, 11 deletions
diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst index 39ada43..25ab8a4 100644 --- a/Doc/library/functions.rst +++ b/Doc/library/functions.rst @@ -545,17 +545,18 @@ available. They are listed here in alphabetical order. .. function:: int([x[, radix]]) - Convert a string or number to a plain integer. If the argument is a string, it - must contain a possibly signed decimal number representable as a Python integer, - possibly embedded in whitespace. The *radix* parameter gives the base for the - conversion and may be any integer in the range [2, 36], or zero. If *radix* is - zero, the proper radix is guessed based on the contents of string; the - interpretation is the same as for integer literals. If *radix* is specified and - *x* is not a string, :exc:`TypeError` is raised. Otherwise, the argument may be - a plain or long integer or a floating point number. Conversion of floating - point numbers to integers truncates (towards zero). If the argument is outside - the integer range a long object will be returned instead. If no arguments are - given, returns ``0``. + Convert a string or number to a plain integer. If the argument is a string, + it must contain a possibly signed decimal number representable as a Python + integer, possibly embedded in whitespace. The *radix* parameter gives the + base for the conversion (which is 10 by default) and may be any integer in + the range [2, 36], or zero. If *radix* is zero, the proper radix is guessed + based on the contents of string; the interpretation is the same as for + integer literals. If *radix* is specified and *x* is not a string, + :exc:`TypeError` is raised. Otherwise, the argument may be a plain or long + integer or a floating point number. Conversion of floating point numbers to + integers truncates (towards zero). If the argument is outside the integer + range a long object will be returned instead. If no arguments are given, + returns ``0``. The integer type is described in :ref:`typesnumeric`. |