diff options
| author | Victor Stinner <vstinner@python.org> | 2020-03-13 17:15:33 (GMT) |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2020-03-13 17:15:33 (GMT) |
| commit | be79373a78c0d75fc715ab64253c9b757987a848 (patch) | |
| tree | 9fba5caff3547b80fbfd2b468339458e7d5d0037 /Doc/c-api/init.rst | |
| parent | ff4584caca04cb3da0dbd5b1e9bf67e40adf5312 (diff) | |
| download | cpython-be79373a78c0d75fc715ab64253c9b757987a848.zip cpython-be79373a78c0d75fc715ab64253c9b757987a848.tar.gz cpython-be79373a78c0d75fc715ab64253c9b757987a848.tar.bz2 | |
bpo-39947: Add PyInterpreterState_Get() function (GH-18979)
* Rename _PyInterpreterState_Get() to PyInterpreterState_Get() and
move it the limited C API.
* Add _PyInterpreterState_Get() alias to PyInterpreterState_Get() for
backward compatibility with Python 3.8.
Diffstat (limited to 'Doc/c-api/init.rst')
| -rw-r--r-- | Doc/c-api/init.rst | 12 |
1 files changed, 12 insertions, 0 deletions
diff --git a/Doc/c-api/init.rst b/Doc/c-api/init.rst index 747278c..661ed59 100644 --- a/Doc/c-api/init.rst +++ b/Doc/c-api/init.rst @@ -1072,6 +1072,18 @@ All of the following functions must be called after :c:func:`Py_Initialize`. to :c:func:`PyThreadState_Clear`. +.. c:function:: PyInterpreterState* PyInterpreterState_Get(void) + + Get the current interpreter. + + Issue a fatal error if there no current Python thread state or no current + interpreter. It cannot return NULL. + + The caller must hold the GIL. + + .. versionadded:: 3.9 + + .. c:function:: PY_INT64_T PyInterpreterState_GetID(PyInterpreterState *interp) Return the interpreter's unique ID. If there was any error in doing |