Gecko [ v99win.today ]

Name	Size	Permission
abstract.html	7.8 KB	-rw-r--r--
allocation.html	24.04 KB	-rw-r--r--
arg.html	64.25 KB	-rw-r--r--
bool.html	11.44 KB	-rw-r--r--
buffer.html	58.49 KB	-rw-r--r--
bytearray.html	18.39 KB	-rw-r--r--
capsule.html	26.78 KB	-rw-r--r--
cell.html	13.74 KB	-rw-r--r--
class.html	14.3 KB	-rw-r--r--
cobject.html	15.67 KB	-rw-r--r--
code.html	15.57 KB	-rw-r--r--
codec.html	29.28 KB	-rw-r--r--
complex.html	25.03 KB	-rw-r--r--
concrete.html	15.93 KB	-rw-r--r--
conversion.html	29.24 KB	-rw-r--r--
datetime.html	35.92 KB	-rw-r--r--
descriptor.html	15.74 KB	-rw-r--r--
dict.html	42.03 KB	-rw-r--r--
exceptions.html	112.66 KB	-rw-r--r--
file.html	28.8 KB	-rw-r--r--
float.html	21.5 KB	-rw-r--r--
function.html	17.69 KB	-rw-r--r--
gcsupport.html	29.5 KB	-rw-r--r--
gen.html	9.84 KB	-rw-r--r--
import.html	43.14 KB	-rw-r--r--
index.html	13.69 KB	-rw-r--r--
init.html	122.91 KB	-rw-r--r--
int.html	24.28 KB	-rw-r--r--
intro.html	57.73 KB	-rw-r--r--
iter.html	11.38 KB	-rw-r--r--
iterator.html	13.32 KB	-rw-r--r--
list.html	31.45 KB	-rw-r--r--
long.html	39.54 KB	-rw-r--r--
mapping.html	20.85 KB	-rw-r--r--
marshal.html	18.82 KB	-rw-r--r--
memory.html	37.51 KB	-rw-r--r--
method.html	16.77 KB	-rw-r--r--
module.html	21.95 KB	-rw-r--r--
none.html	8.76 KB	-rw-r--r--
number.html	64.95 KB	-rw-r--r--
objbuffer.html	14.62 KB	-rw-r--r--
object.html	74.9 KB	-rw-r--r--
objimpl.html	7.59 KB	-rw-r--r--
refcounting.html	14.46 KB	-rw-r--r--
reflection.html	12.81 KB	-rw-r--r--
sequence.html	41.73 KB	-rw-r--r--
set.html	35.44 KB	-rw-r--r--
slice.html	16.89 KB	-rw-r--r--
string.html	46.73 KB	-rw-r--r--
structures.html	41.96 KB	-rw-r--r--
sys.html	26.72 KB	-rw-r--r--
tuple.html	27.17 KB	-rw-r--r--
type.html	19.18 KB	-rw-r--r--
typeobj.html	209.91 KB	-rw-r--r--
unicode.html	160.87 KB	-rw-r--r--
utilities.html	7.88 KB	-rw-r--r--
veryhigh.html	66.91 KB	-rw-r--r--
weakref.html	15.68 KB	-rw-r--r--

Code Editor : int.html

<!DOCTYPE html>

<title>Plain Integer Objects &#8212; Python 2.7.18 documentation</title>
 <link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
 <link rel="stylesheet" type="text/css" href="../_static/classic.css" />
 
 <script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js"></script>
 <script src="../_static/jquery.js"></script>
 <script src="../_static/underscore.js"></script>
 <script src="../_static/doctools.js"></script>
 
 <script src="../_static/sidebar.js"></script>
 
 <link rel="search" type="application/opensearchdescription+xml"
 title="Search within Python 2.7.18 documentation"
 href="../_static/opensearch.xml"/>
 <link rel="author" title="About these documents" href="../about.html" />
 <link rel="index" title="Index" href="../genindex.html" />
 <link rel="search" title="Search" href="../search.html" />
 <link rel="copyright" title="Copyright" href="../copyright.html" />
 <link rel="next" title="Boolean Objects" href="bool.html" />
 <link rel="prev" title="The None Object" href="none.html" />
 <link rel="shortcut icon" type="image/png" href="../_static/py.png" />
 <link rel="canonical" href="file:///usr/share/doc/python2.7/html/c-api/int.html" />
 <script type="text/javascript" src="../_static/copybutton.js"></script>

</head><body>
<div id="outdated-warning" style="padding: .5em; text-align: center; background-color: #FFBABA; color: #6A0E0E;">
 This document is for an old version of Python that is <a href="https://devguide.python.org/devcycle/#end-of-life-branches">no longer supported</a>.
 You should install the python3 and python3-doc packages and read the 
 <a href="file:///usr/share/doc/python3-doc/html/c-api/int.html"> Python documentation for the Python3 version packaged in this release</a>.
</div>
 
 <div class="related" role="navigation" aria-label="related navigation">
 <h3>Navigation</h3>
 <ul>
 <li class="right" style="margin-right: 10px">
 <a href="../genindex.html" title="General Index"
 accesskey="I">index</a></li>
 <li class="right" >
 <a href="../py-modindex.html" title="Python Module Index"
 >modules</a> |</li>
 <li class="right" >
 <a href="bool.html" title="Boolean Objects"
 accesskey="N">next</a> |</li>
 <li class="right" >
 <a href="none.html" title="The None Object"
 accesskey="P">previous</a> |</li>
 <li><img src="../_static/py.png" alt=""
 style="vertical-align: middle; margin-top: -1px"/></li>
 <li><a href="https://www.python.org/">Python</a> &#187;</li>
 <li>
 <a href="../index.html">Python 2.7.18 documentation</a> &#187;
 </li>

<li class="nav-item nav-item-1"><a href="index.html" >Python/C API Reference Manual</a> &#187;</li>
 <li class="nav-item nav-item-2"><a href="concrete.html" accesskey="U">Concrete Objects Layer</a> &#187;</li>
 <li class="nav-item nav-item-this"><a href="">Plain Integer Objects</a></li> 
 </ul>
 </div>

<div class="document">
 <div class="documentwrapper">
 <div class="bodywrapper">
 <div class="body" role="main">
 
 <section id="plain-integer-objects">
<h1>Plain Integer Objects<a class="headerlink" href="#plain-integer-objects" title="Permalink to this headline">¶</a></h1>
<dl class="c type">
<dt class="sig sig-object c" id="c.PyIntObject">
type PyIntObject<a class="headerlink" href="#c.PyIntObject" title="Permalink to this definition">¶</a> </dt>
<dd>This subtype of <a class="reference internal" href="structures.html#c.PyObject" title="PyObject"><code class="xref c c-type docutils literal notranslate">PyObject</code></a> represents a Python integer object.
</dd></dl>

<dl class="c var">
<dt class="sig sig-object c" id="c.PyInt_Type">
<a class="reference internal" href="type.html#c.PyTypeObject" title="PyTypeObject">PyTypeObject</a> PyInt_Type<a class="headerlink" href="#c.PyInt_Type" title="Permalink to this definition">¶</a> </dt>
<dd>This instance of <a class="reference internal" href="type.html#c.PyTypeObject" title="PyTypeObject"><code class="xref c c-type docutils literal notranslate">PyTypeObject</code></a> represents the Python plain integer type.
This is the same object as <code class="docutils literal notranslate">int</code> and <code class="docutils literal notranslate">types.IntType</code>.
</dd></dl>

<dl class="c function">
<dt class="sig sig-object c" id="c.PyInt_Check">
int PyInt_Check(<a class="reference internal" href="structures.html#c.PyObject" title="PyObject">PyObject</a> *o)<a class="headerlink" href="#c.PyInt_Check" title="Permalink to this definition">¶</a> </dt>
<dd>Return true if o is of type <a class="reference internal" href="#c.PyInt_Type" title="PyInt_Type"><code class="xref c c-data docutils literal notranslate">PyInt_Type</code></a> or a subtype of
<a class="reference internal" href="#c.PyInt_Type" title="PyInt_Type"><code class="xref c c-data docutils literal notranslate">PyInt_Type</code></a>.
<div class="versionchanged">
Changed in version 2.2: Allowed subtypes to be accepted.
</div>
</dd></dl>

<dl class="c function">
<dt class="sig sig-object c" id="c.PyInt_CheckExact">
int PyInt_CheckExact(<a class="reference internal" href="structures.html#c.PyObject" title="PyObject">PyObject</a> *o)<a class="headerlink" href="#c.PyInt_CheckExact" title="Permalink to this definition">¶</a> </dt>
<dd>Return true if o is of type <a class="reference internal" href="#c.PyInt_Type" title="PyInt_Type"><code class="xref c c-data docutils literal notranslate">PyInt_Type</code></a>, but not a subtype of
<a class="reference internal" href="#c.PyInt_Type" title="PyInt_Type"><code class="xref c c-data docutils literal notranslate">PyInt_Type</code></a>.
<div class="versionadded">
New in version 2.2.
</div>
</dd></dl>

<dl class="c function">
<dt class="sig sig-object c" id="c.PyInt_FromString">
<a class="reference internal" href="structures.html#c.PyObject" title="PyObject">PyObject</a> *PyInt_FromString(char *str, char **pend, int base)<a class="headerlink" href="#c.PyInt_FromString" title="Permalink to this definition">¶</a> </dt>
<dd>Return a new <a class="reference internal" href="#c.PyIntObject" title="PyIntObject"><code class="xref c c-type docutils literal notranslate">PyIntObject</code></a> or <a class="reference internal" href="long.html#c.PyLongObject" title="PyLongObject"><code class="xref c c-type docutils literal notranslate">PyLongObject</code></a> based on the string
value in str, which is interpreted according to the radix in base. If
pend is non-NULL, <code class="docutils literal notranslate">*pend</code> will point to the first character in str which
follows the representation of the number. If base is <code class="docutils literal notranslate">0</code>, the radix will be
determined based on the leading characters of str: if str starts with
<code class="docutils literal notranslate">'0x'</code> or <code class="docutils literal notranslate">'0X'</code>, radix 16 will be used; if str starts with <code class="docutils literal notranslate">'0'</code>, radix
8 will be used; otherwise radix 10 will be used. If base is not <code class="docutils literal notranslate">0</code>, it
must be between <code class="docutils literal notranslate">2</code> and <code class="docutils literal notranslate">36</code>, inclusive. Leading spaces are ignored. If
there are no digits, <code class="xref py py-exc docutils literal notranslate">ValueError</code> will be raised. If the string represents
a number too large to be contained within the machine’s <code class="xref c c-type docutils literal notranslate">long int</code> type
and overflow warnings are being suppressed, a <a class="reference internal" href="long.html#c.PyLongObject" title="PyLongObject"><code class="xref c c-type docutils literal notranslate">PyLongObject</code></a> will be
returned. If overflow warnings are not being suppressed, NULL will be
returned in this case.
</dd></dl>

<dl class="c function">
<dt class="sig sig-object c" id="c.PyInt_FromLong">
<a class="reference internal" href="structures.html#c.PyObject" title="PyObject">PyObject</a> *PyInt_FromLong(long ival)<a class="headerlink" href="#c.PyInt_FromLong" title="Permalink to this definition">¶</a> </dt>
<dd>Create a new integer object with a value of ival.
The current implementation keeps an array of integer objects for all integers
between <code class="docutils literal notranslate">-5</code> and <code class="docutils literal notranslate">256</code>, when you create an int in that range you actually
just get back a reference to the existing object. So it should be possible to
change the value of <code class="docutils literal notranslate">1</code>. I suspect the behaviour of Python in this case is
undefined. :-)
</dd></dl>

<dl class="c function">
<dt class="sig sig-object c" id="c.PyInt_FromSsize_t">
<a class="reference internal" href="structures.html#c.PyObject" title="PyObject">PyObject</a> *PyInt_FromSsize_t(Py_ssize_t ival)<a class="headerlink" href="#c.PyInt_FromSsize_t" title="Permalink to this definition">¶</a> </dt>
<dd>Create a new integer object with a value of ival. If the value is larger
than <code class="docutils literal notranslate">LONG_MAX</code> or smaller than <code class="docutils literal notranslate">LONG_MIN</code>, a long integer object is
returned.
<div class="versionadded">
New in version 2.5.
</div>
</dd></dl>

<dl class="c function">
<dt class="sig sig-object c" id="c.PyInt_FromSize_t">
<a class="reference internal" href="structures.html#c.PyObject" title="PyObject">PyObject</a> *PyInt_FromSize_t(size_t ival)<a class="headerlink" href="#c.PyInt_FromSize_t" title="Permalink to this definition">¶</a> </dt>
<dd>Create a new integer object with a value of ival. If the value exceeds
<code class="docutils literal notranslate">LONG_MAX</code>, a long integer object is returned.
<div class="versionadded">
New in version 2.5.
</div>
</dd></dl>

<dl class="c function">
<dt class="sig sig-object c" id="c.PyInt_AsLong">
long PyInt_AsLong(<a class="reference internal" href="structures.html#c.PyObject" title="PyObject">PyObject</a> *io)<a class="headerlink" href="#c.PyInt_AsLong" title="Permalink to this definition">¶</a> </dt>
<dd>Will first attempt to cast the object to a <a class="reference internal" href="#c.PyIntObject" title="PyIntObject"><code class="xref c c-type docutils literal notranslate">PyIntObject</code></a>, if it is not
already one, and then return its value. If there is an error, <code class="docutils literal notranslate">-1</code> is
returned, and the caller should check <code class="docutils literal notranslate">PyErr_Occurred()</code> to find out whether
there was an error, or whether the value just happened to be <code class="docutils literal notranslate">-1</code>.
</dd></dl>

<dl class="c function">
<dt class="sig sig-object c" id="c.PyInt_AS_LONG">
long PyInt_AS_LONG(<a class="reference internal" href="structures.html#c.PyObject" title="PyObject">PyObject</a> *io)<a class="headerlink" href="#c.PyInt_AS_LONG" title="Permalink to this definition">¶</a> </dt>
<dd>Return the value of the object io. No error checking is performed.
</dd></dl>

<dl class="c function">
<dt class="sig sig-object c" id="c.PyInt_AsUnsignedLongMask">
unsigned long PyInt_AsUnsignedLongMask(<a class="reference internal" href="structures.html#c.PyObject" title="PyObject">PyObject</a> *io)<a class="headerlink" href="#c.PyInt_AsUnsignedLongMask" title="Permalink to this definition">¶</a> </dt>
<dd>Will first attempt to cast the object to a <a class="reference internal" href="#c.PyIntObject" title="PyIntObject"><code class="xref c c-type docutils literal notranslate">PyIntObject</code></a> or
<a class="reference internal" href="long.html#c.PyLongObject" title="PyLongObject"><code class="xref c c-type docutils literal notranslate">PyLongObject</code></a>, if it is not already one, and then return its value as
unsigned long. This function does not check for overflow.
<div class="versionadded">
New in version 2.3.
</div>
</dd></dl>

<dl class="c function">
<dt class="sig sig-object c">
unsigned PY_LONG_LONG PyInt_AsUnsignedLongLongMask(PyObject *io)</dt>
<dd>Will first attempt to cast the object to a <a class="reference internal" href="#c.PyIntObject" title="PyIntObject"><code class="xref c c-type docutils literal notranslate">PyIntObject</code></a> or
<a class="reference internal" href="long.html#c.PyLongObject" title="PyLongObject"><code class="xref c c-type docutils literal notranslate">PyLongObject</code></a>, if it is not already one, and then return its value as
unsigned long long, without checking for overflow.
<div class="versionadded">
New in version 2.3.
</div>
</dd></dl>

<dl class="c function">
<dt class="sig sig-object c" id="c.PyInt_AsSsize_t">
Py_ssize_t PyInt_AsSsize_t(<a class="reference internal" href="structures.html#c.PyObject" title="PyObject">PyObject</a> *io)<a class="headerlink" href="#c.PyInt_AsSsize_t" title="Permalink to this definition">¶</a> </dt>
<dd>Will first attempt to cast the object to a <a class="reference internal" href="#c.PyIntObject" title="PyIntObject"><code class="xref c c-type docutils literal notranslate">PyIntObject</code></a> or
<a class="reference internal" href="long.html#c.PyLongObject" title="PyLongObject"><code class="xref c c-type docutils literal notranslate">PyLongObject</code></a>, if it is not already one, and then return its value as
<code class="xref c c-type docutils literal notranslate">Py_ssize_t</code>.
<div class="versionadded">
New in version 2.5.
</div>
</dd></dl>

<dl class="c function">
<dt class="sig sig-object c" id="c.PyInt_GetMax">
long PyInt_GetMax()<a class="headerlink" href="#c.PyInt_GetMax" title="Permalink to this definition">¶</a> </dt>
<dd>Return the system’s idea of the largest integer it can handle
(<code class="xref py py-const docutils literal notranslate">LONG_MAX</code>, as defined in the system header files).
</dd></dl>

<dl class="c function">
<dt class="sig sig-object c" id="c.PyInt_ClearFreeList">
int PyInt_ClearFreeList()<a class="headerlink" href="#c.PyInt_ClearFreeList" title="Permalink to this definition">¶</a> </dt>
<dd>Clear the integer free list. Return the number of items that could not
be freed.
<div class="versionadded">
New in version 2.6.
</div>
</dd></dl>

</section>

<div class="clearer"></div>
 </div>
 </div>
 </div>
 <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
 <div class="sphinxsidebarwrapper">
 <h4>Previous topic</h4>
 <a href="none.html"
 title="previous chapter">The <code class="docutils literal notranslate">None</code> Object</a>
 <h4>Next topic</h4>
 <a href="bool.html"
 title="next chapter">Boolean Objects</a>
 <div role="note" aria-label="source link">
 <h3>This Page</h3>
 <ul class="this-page-menu">
 <li><a href="../_sources/c-api/int.rst.txt"
 rel="nofollow">Show Source</a></li>
 </ul>
 </div>
<div id="searchbox" style="display: none" role="search">
 <h3 id="searchlabel">Quick search</h3>
 <div class="searchformwrapper">
 <form class="search" action="../search.html" method="get">
 <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
 <input type="submit" value="Go" />
 </form>
 </div>
</div>
<script>$('#searchbox').show(0);</script>
 </div>
 </div>
 <div class="clearer"></div>
 </div> 
 <div class="related" role="navigation" aria-label="related navigation">
 <h3>Navigation</h3>
 <ul>
 <li class="right" style="margin-right: 10px">
 <a href="../genindex.html" title="General Index"
 >index</a></li>
 <li class="right" >
 <a href="../py-modindex.html" title="Python Module Index"
 >modules</a> |</li>
 <li class="right" >
 <a href="bool.html" title="Boolean Objects"
 >next</a> |</li>
 <li class="right" >
 <a href="none.html" title="The None Object"
 >previous</a> |</li>
 <li><img src="../_static/py.png" alt=""
 style="vertical-align: middle; margin-top: -1px"/></li>
 <li><a href="https://www.python.org/">Python</a> &#187;</li>
 <li>
 <a href="../index.html">Python 2.7.18 documentation</a> &#187;
 </li>

<li class="nav-item nav-item-1"><a href="index.html" >Python/C API Reference Manual</a> &#187;</li>
 <li class="nav-item nav-item-2"><a href="concrete.html" >Concrete Objects Layer</a> &#187;</li>
 <li class="nav-item nav-item-this"><a href="">Plain Integer Objects</a></li> 
 </ul>
 </div> 
 <div class="footer">
 &copy; <a href="../copyright.html">Copyright</a> 1990-2024, Python Software Foundation.
 
 The Python Software Foundation is a non-profit corporation.
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 
 Last updated on December 09, 2024.
 <a href="../bugs.html">Found a bug</a>?
 
 Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 4.3.2.
 </div>

</body>
</html>

${this.title}

Code Editor : int.html