Doc/c-api/none.rst

   1 .. highlightlang:: c
   2
   3 .. _noneobject:
   4
   5 The None Object
   6 ---------------
   7
   8 .. index:: object: None
   9
  10 Note that the :ctype:`PyTypeObject` for ``None`` is not directly exposed in the
  11 Python/C API.  Since ``None`` is a singleton, testing for object identity (using
  12 ``==`` in C) is sufficient. There is no :cfunc:`PyNone_Check` function for the
  13 same reason.
  14
  15
  16 .. cvar:: PyObject* Py_None
  17
  18    The Python ``None`` object, denoting lack of value.  This object has no methods.
  19    It needs to be treated just like any other object with respect to reference
  20    counts.
  21
  22
  23 .. cmacro:: Py_RETURN_NONE
  24
  25    Properly handle returning :cdata:`Py_None` from within a C function (that is,
  26    increment the reference count of None and return it.)