summaryrefslogtreecommitdiffstats
path: root/Doc/c-api/none.rst
blob: 1a497652ac5655da6477201fc666c4a35f8bc221 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
.. highlight:: c

.. _noneobject:

The ``None`` Object
-------------------

.. index:: pair: object; None

Note that the :c:type:`PyTypeObject` for ``None`` is not directly exposed in the
Python/C API.  Since ``None`` is a singleton, testing for object identity (using
``==`` in C) is sufficient. There is no :c:func:`PyNone_Check` function for the
same reason.


.. c:var:: PyObject* Py_None

   The Python ``None`` object, denoting lack of value.  This object has no methods
   and is `immortal <https://peps.python.org/pep-0683/>`_.

.. versionchanged:: 3.12
   :c:data:`Py_None` is immortal.

.. c:macro:: Py_RETURN_NONE

   Return :c:data:`Py_None` from a function.