/
githubmirror
/
cpython
Обзор
Документация
Войти
/
githubmirror
/
cpython
Код
Запросы
0
Пакеты
0
Релизы
0
Аналитика
Безопасность
main
Doc/c-api/sentinel.rst
47 строк
2 KB
Jelle Zijlstra
gh-148829: Make sentinels' repr and module customizable (#149654)
19 май 2026, 19:18
Не верифицирован
19 май 2026, 19:18
0821803
Код
Авторство
О чём код?
.. highlight:: c .. _sentinelobjects: Sentinel objects ---------------- .. c:var:: PyTypeObject PySentinel_Type This instance of :c:type:`PyTypeObject` represents the Python :class:`sentinel` type. This is the same object as :class:`sentinel`. .. versionadded:: 3.15 .. c:function:: int PySentinel_Check(PyObject *o) Return true if *o* is a :class:`sentinel` object or a subtype. The :class:`sentinel` type does not currently allow subclasses, so this check is exact. Future Python versions may choose to allow subtyping. This function always succeeds. .. versionadded:: 3.15 .. c:function:: int PySentinel_CheckExact(PyObject *o) Return true if *o* is a :class:`sentinel` object, but not a subtype. The :class:`sentinel` type does not currently allow subclasses. Future Python versions may choose to allow subtyping. This function always succeeds. .. versionadded:: 3.15 .. c:function:: PyObject* PySentinel_New(const char *name, const char *module_name, const char *repr) Return a new :class:`sentinel` object with :attr:`~sentinel.__name__` set to *name* and :attr:`~sentinel.__module__` set to *module_name*. *name* must not be ``NULL``. If *module_name* is ``NULL``, :attr:`~sentinel.__module__` is set to ``None``. If *repr* is ``NULL``, ``repr()`` returns :attr:`~sentinel.__name__`. Return ``NULL`` with an exception set on failure. For pickling to work, *module_name* must be the name of an importable module, and the sentinel must be accessible from that module under a path matching *name*. Pickle treats *name* as a global variable name in *module_name* (see :meth:`object.__reduce__`). .. versionadded:: 3.15