Commit 08294317 authored by Fred Drake's avatar Fred Drake

Update the description of int() to include the radix parameter;

omission noted on c.l.py by Aahz Maruch.

Swapped the order of the descriptions of int() and intern() so that
int() comes first (the functions are in alphabetic order).
parent 164dd8e0
...@@ -312,6 +312,22 @@ module from which it is called). ...@@ -312,6 +312,22 @@ module from which it is called).
Equivalent to \code{eval(raw_input(\var{prompt}))}. Equivalent to \code{eval(raw_input(\var{prompt}))}.
\end{funcdesc} \end{funcdesc}
\begin{funcdesc}{int}{x\optional{, 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;
this behaves identical to \code{string.atoi(\var{x}\optional{,
\var{radix}})}. The \var{radix} parameter gives the base for the
conversion and may be any integer in the range $[2, 36]$. If
\var{radix} is specified and \var{x} is not a string,
\exception{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 is defined by the C semantics; normally
the conversion truncates towards zero.\footnote{This is ugly --- the
language definition should require truncation towards zero.}
\end{funcdesc}
\begin{funcdesc}{intern}{string} \begin{funcdesc}{intern}{string}
Enter \var{string} in the table of ``interned'' strings and return Enter \var{string} in the table of ``interned'' strings and return
the interned string -- which is \var{string} itself or a copy. the interned string -- which is \var{string} itself or a copy.
...@@ -325,18 +341,6 @@ module from which it is called). ...@@ -325,18 +341,6 @@ module from which it is called).
garbage collected). garbage collected).
\end{funcdesc} \end{funcdesc}
\begin{funcdesc}{int}{x}
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;
this behaves identical to \code{string.atoi(\var{x})}.
Otherwise, the argument may be a plain or
long integer or a floating point number. Conversion of floating
point numbers to integers is defined by the C semantics; normally
the conversion truncates towards zero.\footnote{This is ugly --- the
language definition should require truncation towards zero.}
\end{funcdesc}
\begin{funcdesc}{isinstance}{object, class} \begin{funcdesc}{isinstance}{object, class}
Return true if the \var{object} argument is an instance of the Return true if the \var{object} argument is an instance of the
\var{class} argument, or of a (direct or indirect) subclass thereof. \var{class} argument, or of a (direct or indirect) subclass thereof.
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment