Gecko [ v99win.today ]

Name	Size	Permission
abstract.rst.txt	702 B	-rw-r--r--
allocation.rst.txt	4.68 KB	-rw-r--r--
arg.rst.txt	25.39 KB	-rw-r--r--
bool.rst.txt	1.27 KB	-rw-r--r--
buffer.rst.txt	22.43 KB	-rw-r--r--
bytearray.rst.txt	2.13 KB	-rw-r--r--
capsule.rst.txt	5.61 KB	-rw-r--r--
cell.rst.txt	1.89 KB	-rw-r--r--
class.rst.txt	1.82 KB	-rw-r--r--
cobject.rst.txt	1.83 KB	-rw-r--r--
code.rst.txt	1.6 KB	-rw-r--r--
codec.rst.txt	4.53 KB	-rw-r--r--
complex.rst.txt	3.98 KB	-rw-r--r--
concrete.rst.txt	1.92 KB	-rw-r--r--
conversion.rst.txt	6.93 KB	-rw-r--r--
datetime.rst.txt	6.26 KB	-rw-r--r--
descriptor.rst.txt	1.27 KB	-rw-r--r--
dict.rst.txt	7.58 KB	-rw-r--r--
exceptions.rst.txt	34.66 KB	-rw-r--r--
file.rst.txt	6.05 KB	-rw-r--r--
float.rst.txt	3.29 KB	-rw-r--r--
function.rst.txt	2.36 KB	-rw-r--r--
gcsupport.rst.txt	6.43 KB	-rw-r--r--
gen.rst.txt	920 B	-rw-r--r--
import.rst.txt	10.96 KB	-rw-r--r--
index.rst.txt	578 B	-rw-r--r--
init.rst.txt	48.01 KB	-rw-r--r--
int.rst.txt	4.47 KB	-rw-r--r--
intro.rst.txt	27.81 KB	-rw-r--r--
iter.rst.txt	1.36 KB	-rw-r--r--
iterator.rst.txt	1.75 KB	-rw-r--r--
list.rst.txt	6.27 KB	-rw-r--r--
long.rst.txt	7.99 KB	-rw-r--r--
mapping.rst.txt	2.81 KB	-rw-r--r--
marshal.rst.txt	3.89 KB	-rw-r--r--
memory.rst.txt	11.29 KB	-rw-r--r--
method.rst.txt	2.05 KB	-rw-r--r--
module.rst.txt	3.78 KB	-rw-r--r--
none.rst.txt	697 B	-rw-r--r--
number.rst.txt	11.66 KB	-rw-r--r--
objbuffer.rst.txt	2.46 KB	-rw-r--r--
object.rst.txt	17.08 KB	-rw-r--r--
objimpl.rst.txt	305 B	-rw-r--r--
refcounting.rst.txt	2.87 KB	-rw-r--r--
reflection.rst.txt	1.53 KB	-rw-r--r--
sequence.rst.txt	8.51 KB	-rw-r--r--
set.rst.txt	6.43 KB	-rw-r--r--
slice.rst.txt	2.91 KB	-rw-r--r--
string.rst.txt	15.06 KB	-rw-r--r--
structures.rst.txt	14.62 KB	-rw-r--r--
sys.rst.txt	5.58 KB	-rw-r--r--
tuple.rst.txt	5.83 KB	-rw-r--r--
type.rst.txt	2.7 KB	-rw-r--r--
typeobj.rst.txt	65.37 KB	-rw-r--r--
unicode.rst.txt	44.07 KB	-rw-r--r--
utilities.rst.txt	415 B	-rw-r--r--
veryhigh.rst.txt	13.05 KB	-rw-r--r--
weakref.rst.txt	2.75 KB	-rw-r--r--

Code Editor : int.rst.txt

.. highlightlang:: c

.. _intobjects:

Plain Integer Objects
---------------------

.. index:: object: integer

.. c:type:: PyIntObject

This subtype of :c:type:`PyObject` represents a Python integer object.

.. c:var:: PyTypeObject PyInt_Type

.. index:: single: IntType (in modules types)

This instance of :c:type:`PyTypeObject` represents the Python plain integer type.
   This is the same object as ``int`` and ``types.IntType``.

.. c:function:: int PyInt_Check(PyObject *o)

Return true if *o* is of type :c:data:`PyInt_Type` or a subtype of
   :c:data:`PyInt_Type`.

.. versionchanged:: 2.2
      Allowed subtypes to be accepted.

.. c:function:: int PyInt_CheckExact(PyObject *o)

Return true if *o* is of type :c:data:`PyInt_Type`, but not a subtype of
   :c:data:`PyInt_Type`.

.. versionadded:: 2.2

.. c:function:: PyObject* PyInt_FromString(char *str, char **pend, int base)

Return a new :c:type:`PyIntObject` or :c:type:`PyLongObject` based on the string
   value in *str*, which is interpreted according to the radix in *base*.  If
   *pend* is non-*NULL*, ``*pend`` will point to the first character in *str* which
   follows the representation of the number.  If *base* is ``0``, the radix will be
   determined based on the leading characters of *str*: if *str* starts with
   ``'0x'`` or ``'0X'``, radix 16 will be used; if *str* starts with ``'0'``, radix
   8 will be used; otherwise radix 10 will be used.  If *base* is not ``0``, it
   must be between ``2`` and ``36``, inclusive.  Leading spaces are ignored.  If
   there are no digits, :exc:`ValueError` will be raised.  If the string represents
   a number too large to be contained within the machine's :c:type:`long int` type
   and overflow warnings are being suppressed, a :c:type:`PyLongObject` will be
   returned.  If overflow warnings are not being suppressed, *NULL* will be
   returned in this case.

.. c:function:: PyObject* PyInt_FromLong(long ival)

Create a new integer object with a value of *ival*.

The current implementation keeps an array of integer objects for all integers
   between ``-5`` and ``256``, 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 ``1``.  I suspect the behaviour of Python in this case is
   undefined. :-)

.. c:function:: PyObject* PyInt_FromSsize_t(Py_ssize_t ival)

Create a new integer object with a value of *ival*. If the value is larger
   than ``LONG_MAX`` or smaller than ``LONG_MIN``, a long integer object is
   returned.

.. versionadded:: 2.5

.. c:function:: PyObject* PyInt_FromSize_t(size_t ival)

Create a new integer object with a value of *ival*. If the value exceeds
   ``LONG_MAX``, a long integer object is returned.

.. versionadded:: 2.5

.. c:function:: long PyInt_AsLong(PyObject *io)

Will first attempt to cast the object to a :c:type:`PyIntObject`, if it is not
   already one, and then return its value. If there is an error, ``-1`` is
   returned, and the caller should check ``PyErr_Occurred()`` to find out whether
   there was an error, or whether the value just happened to be ``-1``.

.. c:function:: long PyInt_AS_LONG(PyObject *io)

Return the value of the object *io*.  No error checking is performed.

.. c:function:: unsigned long PyInt_AsUnsignedLongMask(PyObject *io)

Will first attempt to cast the object to a :c:type:`PyIntObject` or
   :c:type:`PyLongObject`, if it is not already one, and then return its value as
   unsigned long.  This function does not check for overflow.

.. versionadded:: 2.3

.. c:function:: unsigned PY_LONG_LONG PyInt_AsUnsignedLongLongMask(PyObject *io)

Will first attempt to cast the object to a :c:type:`PyIntObject` or
   :c:type:`PyLongObject`, if it is not already one, and then return its value as
   unsigned long long, without checking for overflow.

.. versionadded:: 2.3

.. c:function:: Py_ssize_t PyInt_AsSsize_t(PyObject *io)

Will first attempt to cast the object to a :c:type:`PyIntObject` or
   :c:type:`PyLongObject`, if it is not already one, and then return its value as
   :c:type:`Py_ssize_t`.

.. versionadded:: 2.5

.. c:function:: long PyInt_GetMax()

.. index:: single: LONG_MAX

Return the system's idea of the largest integer it can handle
   (:const:`LONG_MAX`, as defined in the system header files).

.. c:function:: int PyInt_ClearFreeList()

Clear the integer free list. Return the number of items that could not
   be freed.

.. versionadded:: 2.6

${this.title}

Code Editor : int.rst.txt