mirror of https://github.com/python/cpython.git
55 lines
1.7 KiB
C
55 lines
1.7 KiB
C
|
|
/* C objects to be exported from one extension module to another.
|
|
|
|
C objects are used for communication between extension modules.
|
|
They provide a way for an extension module to export a C interface
|
|
to other extension modules, so that extension modules can use the
|
|
Python import mechanism to link to one another.
|
|
|
|
*/
|
|
|
|
#ifndef Py_COBJECT_H
|
|
#define Py_COBJECT_H
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
PyAPI_DATA(PyTypeObject) PyCObject_Type;
|
|
|
|
#define PyCObject_Check(op) (Py_TYPE(op) == &PyCObject_Type)
|
|
|
|
/* Create a PyCObject from a pointer to a C object and an optional
|
|
destructor function. If the second argument is non-null, then it
|
|
will be called with the first argument if and when the PyCObject is
|
|
destroyed.
|
|
|
|
*/
|
|
PyAPI_FUNC(PyObject *) PyCObject_FromVoidPtr(
|
|
void *cobj, void (*destruct)(void*));
|
|
|
|
|
|
/* Create a PyCObject from a pointer to a C object, a description object,
|
|
and an optional destructor function. If the third argument is non-null,
|
|
then it will be called with the first and second arguments if and when
|
|
the PyCObject is destroyed.
|
|
*/
|
|
PyAPI_FUNC(PyObject *) PyCObject_FromVoidPtrAndDesc(
|
|
void *cobj, void *desc, void (*destruct)(void*,void*));
|
|
|
|
/* Retrieve a pointer to a C object from a PyCObject. */
|
|
PyAPI_FUNC(void *) PyCObject_AsVoidPtr(PyObject *);
|
|
|
|
/* Retrieve a pointer to a description object from a PyCObject. */
|
|
PyAPI_FUNC(void *) PyCObject_GetDesc(PyObject *);
|
|
|
|
/* Import a pointer to a C object from a module using a PyCObject. */
|
|
PyAPI_FUNC(void *) PyCObject_Import(char *module_name, char *cobject_name);
|
|
|
|
/* Modify a C object. Fails (==0) if object has a destructor. */
|
|
PyAPI_FUNC(int) PyCObject_SetVoidPtr(PyObject *self, void *cobj);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
#endif /* !Py_COBJECT_H */
|