mirror of https://github.com/python/cpython
Document hexversion (incompletely explained) and version_info (easily
explained).
This commit is contained in:
parent
801c08d700
commit
4d65d73686
|
@ -138,6 +138,28 @@ generally one higher than you might expect, because it includes the
|
|||
(temporary) reference as an argument to \function{getrefcount()}.
|
||||
\end{funcdesc}
|
||||
|
||||
\begin{datadesc}{hexversion}
|
||||
The version number encoded as a single integer. This is guaranteed to
|
||||
increase with each version, including proper support for
|
||||
non-production releases. For example, to test that the Python
|
||||
interpreter is at least version 1.5.2, use:
|
||||
|
||||
\begin{verbatim}
|
||||
if sys.hexversion >= 0x010502F0:
|
||||
# use some advanced feature
|
||||
...
|
||||
else:
|
||||
# use an alternative implementation or warn the user
|
||||
...
|
||||
\end{verbatim}
|
||||
|
||||
This is called \samp{hexversion} since it only really looks meaningful
|
||||
when viewed as the result of passing it to the built-in
|
||||
\function{hex()} function. The \code{version_info} value may be used
|
||||
for a more human-friendly encoding of the same information.
|
||||
\versionadded{1.5.2}
|
||||
\end{datadesc}
|
||||
|
||||
\begin{datadesc}{last_type}
|
||||
\dataline{last_value}
|
||||
\dataline{last_traceback}
|
||||
|
@ -304,6 +326,16 @@ directories (where appropriate on each platform). An example:
|
|||
\end{verbatim}
|
||||
\end{datadesc}
|
||||
|
||||
\begin{datadesc}{version_info}
|
||||
A tuple containing the four components of the version number:
|
||||
\var{major}, \var{minor}, \var{micro} as integers, and
|
||||
\var{releaselevel} as a string. The \var{releaselevel} value will be
|
||||
an empty string for a final release. The \code{version_info} value
|
||||
corresponding to the \code{version} string shown above is
|
||||
\code{(1, 5, 2, '')}.
|
||||
\versionadded{1.6}
|
||||
\end{datadesc}
|
||||
|
||||
\begin{datadesc}{winver}
|
||||
The version number used to form registry keys on Windows platforms.
|
||||
This is stored as string resource 1000 in the Python DLL. The value
|
||||
|
|
Loading…
Reference in New Issue