Python C接口函数说明

python C++接口函数
Python3.6提供给C/C++接口函数，基本都是定义pylifecycle.h，pythonrun.h，ceval.h中。

Py_Initialize() 和 Py_Finalize()
C++应用程序调用Python脚本之前，必须先调用Py_Initialize()进行初始化，这个API用来分配Python解释器使用的全局资源，应用程序结束时需要调用Py_Finalize()来关闭Python的使用环境。
Py_IsInitialized()
用来判断Python解释器是否初始化成功，true为成功，false为失败。
PyErr_Print() & PyErr_Clear()
执行Python出错时，PyErr_Print()可将错误信息显示出来，PyErr_Clear()将错误信息在Python解释器的缓存清除。
PyRun_SimpleString()
这个函数能够用来执行简单的Python语句。
PyEval_InitThreads()
如果使用多线程调用Python脚本，就需要在初始化Python解释器时调用PyEval_InitThreads()来启用线程支持（导致Python内部启用线程锁），最好在主线程启动时就调用。该API同时也锁定全局解释锁，所以，还需要在初始化完成后需要自行释放锁。
如果不需要使用多线程，不建议启用该选项，互斥锁也会不可避免的增加系统开销。
PyEval_AcquireLock() & PyEval_ReleaseLock()
因为Python编辑器不是线程安全的，为了支持多线程， Python 使用了互斥使访问内部数据结构串行化。这种互斥即 “全局解释器锁 – global interpreter lock”，当某个线程想使用 Python 的C API的时候，它必须获得全局解释器锁。所以多线程调用Python脚本前必须先持有这个全局解释器锁，然后才能进行对Python的一系列操作。
调用了 PyEval_AcquireLock之后，可以安全地假定你的线程已经持有了锁，其他相关线程不是被阻塞就是在执行与 Python 解析器无关的代码。之后就可以开始执行与Python相关的代码了。
调用了 PyEval_AcquireLock取得了锁之后，必须确保运行完需要的代码后调用 PyEval_ReleaseLock 来释放它，否则就会导致线程死锁并冻结其他 Python 线程。
PyThreadState对象及其相关函数
每个Python 线程都需要维护自己的状态信息，在被Python解释器执行时，需要先切换线程的状态信息，才可以开始执行相应的代码，这个线程状态信息就是用PyThreadState这个对象来描述的。

PyThreadState：每个Python 线程维护自己的状态信息，存储在 PyThreadState对象中。在多线程应用中用 C 语言调用 Python API 函数时，你必须维护自己的 PyThreadState 对象以便能安全地执行并发的 Python 代码。
PyInterpreterState：描述了几个协作线程共享的状态，属于同一解释器的线程共享它们的模块维护和几个其他的内部子项。
PyThreadState_Get()：得到当前PyThreadState的指针。一般用在初始化时用来得到主线程的PyThreadState对象。
PyThreadState_New()：为新的C++线程创建一个 PyThreadState 对象，需要用到既有的 PyInterpreterState 对象。该对象为所有参与的线程所共享的信息，初始化 Python 时，会自动创建一个 PyInterpreterState 对象，附加在主线程的 PyThreadState 对象上， 所以可以利用PyInterpreterState 对象创建新的 PyThreadState。
PyThreadState_Swap()：将要执行Python代码的线程特定的PyThreadState对象加载到解释器
PyThreadState_Clear()：重置线程状态对象的所有相关信息。
PyThreadState_Delete()：销毁一个线程状态对象，该对象的线程状态必须提前调用 PyThreadState_Clear() 进行清除。
以下是几个进阶的接口函数，这些函数可以将全局解释器的加锁和释放锁的操作，以及线程切换的操作封装起来，比较方便。

*PyEval_AcquireThread(PyThreadState tstate)
获得全局解释器锁并将当前线程状态设定为 tstate ，它不能为NULL。锁必须提前创建。如果线程已经拥有锁，会发生死锁。
*PyEval_ReleaseThread(PyThreadState tstate)
重置当前线程状态为NULL并释放全局解释器锁。锁必须提前创建并且以在当前线程中获得。参数 tstate 不能为 NULL。它只能用于校验它描述的当前线程状态——如果它不对，会报告一个致命错误。这个函数在编译时禁用线程支持的情况下不可用。
PyGILState_STATE state = PyGILState_Ensure()
获得全局解释器锁并自动创建一个线程状态，返回值是一个不透明的线程状态“句柄”。
PyGILState_Release(PyGILState_STATE state)
释放全局解释器锁，Python解析器线程状态切换到调用PyGILState_Acquire之前的状态。
PyGILState_Ensure() 和 PyGILState_Release()需要成对出现，仅在CPython中有效，这样就能实现Python解释器的锁功能。只有在关闭Python的使用环境时，可以不再需要调用PyGILState_Release()函数