blob: 35276260d0821b765a3dce8e4740113f0db97c85 [file] [log] [blame]
Guido van Rossuma3309961993-07-28 09:05:47 +00001#ifndef Py_CEVAL_H
2#define Py_CEVAL_H
3#ifdef __cplusplus
4extern "C" {
5#endif
6
Guido van Rossumf70e43a1991-02-19 12:39:46 +00007
Guido van Rossumff4949e1992-08-05 19:58:53 +00008/* Interface to random parts in ceval.c */
Guido van Rossum3f5da241990-12-20 15:06:42 +00009
Guido van Rossum43466ec1998-12-04 18:48:25 +000010DL_IMPORT(PyObject *) PyEval_CallObjectWithKeywords
Fred Drake5eb6d4e2000-07-08 23:37:28 +000011 (PyObject *, PyObject *, PyObject *);
Guido van Rossuma0490311991-07-27 21:33:03 +000012
Guido van Rossum83684531999-03-17 18:44:39 +000013/* DLL-level Backwards compatibility: */
14#undef PyEval_CallObject
Fred Drake5eb6d4e2000-07-08 23:37:28 +000015DL_IMPORT(PyObject *) PyEval_CallObject(PyObject *, PyObject *);
Guido van Rossum83684531999-03-17 18:44:39 +000016
Guido van Rossumd7ed6831997-08-30 15:02:50 +000017/* Inline this */
18#define PyEval_CallObject(func,arg) \
19 PyEval_CallObjectWithKeywords(func, arg, (PyObject *)NULL)
20
Fred Drake5eb6d4e2000-07-08 23:37:28 +000021DL_IMPORT(PyObject *) PyEval_CallFunction(PyObject *obj, char *format, ...);
22DL_IMPORT(PyObject *) PyEval_CallMethod(PyObject *obj,
23 char *methodname, char *format, ...);
Guido van Rossum3d109a01998-08-08 20:53:36 +000024
Fred Drake5eb6d4e2000-07-08 23:37:28 +000025DL_IMPORT(PyObject *) PyEval_GetBuiltins(void);
26DL_IMPORT(PyObject *) PyEval_GetGlobals(void);
27DL_IMPORT(PyObject *) PyEval_GetLocals(void);
28DL_IMPORT(PyObject *) PyEval_GetOwner(void);
29DL_IMPORT(PyObject *) PyEval_GetFrame(void);
30DL_IMPORT(int) PyEval_GetRestricted(void);
Guido van Rossum3f5da241990-12-20 15:06:42 +000031
Fred Drake5eb6d4e2000-07-08 23:37:28 +000032DL_IMPORT(int) Py_FlushLine(void);
Guido van Rossumff4949e1992-08-05 19:58:53 +000033
Thomas Wouters334fb892000-07-25 12:56:38 +000034DL_IMPORT(int) Py_AddPendingCall(int (*func)(void *), void *arg);
Fred Drake5eb6d4e2000-07-08 23:37:28 +000035DL_IMPORT(int) Py_MakePendingCalls(void);
Guido van Rossum95664081994-09-14 13:23:36 +000036
Tim Peters51de6902000-09-01 00:01:58 +000037DL_IMPORT(void) Py_SetRecursionLimit(int);
38DL_IMPORT(int) Py_GetRecursionLimit(void);
Guido van Rossumff4949e1992-08-05 19:58:53 +000039
40/* Interface for threads.
41
42 A module that plans to do a blocking system call (or something else
43 that lasts a long time and doesn't touch Python data) can allow other
44 threads to run as follows:
45
46 ...preparations here...
Guido van Rossumcaa63801995-01-12 11:45:45 +000047 Py_BEGIN_ALLOW_THREADS
Guido van Rossumff4949e1992-08-05 19:58:53 +000048 ...blocking system call here...
Guido van Rossumcaa63801995-01-12 11:45:45 +000049 Py_END_ALLOW_THREADS
Guido van Rossum66cb3111994-12-30 15:33:50 +000050 ...interpret result here...
Guido van Rossumff4949e1992-08-05 19:58:53 +000051
Guido van Rossumcaa63801995-01-12 11:45:45 +000052 The Py_BEGIN_ALLOW_THREADS/Py_END_ALLOW_THREADS pair expands to a
53 {}-surrounded block.
Guido van Rossumff4949e1992-08-05 19:58:53 +000054 To leave the block in the middle (e.g., with return), you must insert
Skip Montanaro682c25a2000-09-15 18:19:27 +000055 a line containing Py_BLOCK_THREADS before the return, e.g.
Guido van Rossumff4949e1992-08-05 19:58:53 +000056
57 if (...premature_exit...) {
Guido van Rossumcaa63801995-01-12 11:45:45 +000058 Py_BLOCK_THREADS
59 PyErr_SetFromErrno(PyExc_IOError);
Guido van Rossumff4949e1992-08-05 19:58:53 +000060 return NULL;
61 }
62
63 An alternative is:
64
Guido van Rossumcaa63801995-01-12 11:45:45 +000065 Py_BLOCK_THREADS
Guido van Rossumff4949e1992-08-05 19:58:53 +000066 if (...premature_exit...) {
Guido van Rossumcaa63801995-01-12 11:45:45 +000067 PyErr_SetFromErrno(PyExc_IOError);
Guido van Rossumff4949e1992-08-05 19:58:53 +000068 return NULL;
69 }
Guido van Rossumcaa63801995-01-12 11:45:45 +000070 Py_UNBLOCK_THREADS
Guido van Rossumff4949e1992-08-05 19:58:53 +000071
72 For convenience, that the value of 'errno' is restored across
Skip Montanaro682c25a2000-09-15 18:19:27 +000073 Py_END_ALLOW_THREADS and Py_BLOCK_THREADS.
Guido van Rossumff4949e1992-08-05 19:58:53 +000074
Guido van Rossumcaa63801995-01-12 11:45:45 +000075 WARNING: NEVER NEST CALLS TO Py_BEGIN_ALLOW_THREADS AND
76 Py_END_ALLOW_THREADS!!!
Guido van Rossumff4949e1992-08-05 19:58:53 +000077
Guido van Rossumcaa63801995-01-12 11:45:45 +000078 The function PyEval_InitThreads() should be called only from
Guido van Rossumff4949e1992-08-05 19:58:53 +000079 initthread() in "threadmodule.c".
80
81 Note that not yet all candidates have been converted to use this
82 mechanism!
83*/
84
Fred Drake5eb6d4e2000-07-08 23:37:28 +000085extern DL_IMPORT(PyThreadState *) PyEval_SaveThread(void);
86extern DL_IMPORT(void) PyEval_RestoreThread(PyThreadState *);
Guido van Rossumff4949e1992-08-05 19:58:53 +000087
Guido van Rossumb6775db1994-08-01 11:34:53 +000088#ifdef WITH_THREAD
Guido van Rossumff4949e1992-08-05 19:58:53 +000089
Fred Drake5eb6d4e2000-07-08 23:37:28 +000090extern DL_IMPORT(void) PyEval_InitThreads(void);
91extern DL_IMPORT(void) PyEval_AcquireLock(void);
92extern DL_IMPORT(void) PyEval_ReleaseLock(void);
93extern DL_IMPORT(void) PyEval_AcquireThread(PyThreadState *tstate);
94extern DL_IMPORT(void) PyEval_ReleaseThread(PyThreadState *tstate);
Tim Peters8ebe84d2000-08-27 20:00:35 +000095extern DL_IMPORT(void) PyEval_ReInitThreads(void);
Guido van Rossum2fca21f71997-07-18 23:56:58 +000096
Guido van Rossumcaa63801995-01-12 11:45:45 +000097#define Py_BEGIN_ALLOW_THREADS { \
Guido van Rossum2fca21f71997-07-18 23:56:58 +000098 PyThreadState *_save; \
Guido van Rossumcaa63801995-01-12 11:45:45 +000099 _save = PyEval_SaveThread();
100#define Py_BLOCK_THREADS PyEval_RestoreThread(_save);
101#define Py_UNBLOCK_THREADS _save = PyEval_SaveThread();
102#define Py_END_ALLOW_THREADS PyEval_RestoreThread(_save); \
Guido van Rossumff4949e1992-08-05 19:58:53 +0000103 }
104
Guido van Rossumb6775db1994-08-01 11:34:53 +0000105#else /* !WITH_THREAD */
Guido van Rossumff4949e1992-08-05 19:58:53 +0000106
Guido van Rossumcaa63801995-01-12 11:45:45 +0000107#define Py_BEGIN_ALLOW_THREADS {
108#define Py_BLOCK_THREADS
109#define Py_UNBLOCK_THREADS
110#define Py_END_ALLOW_THREADS }
Guido van Rossumff4949e1992-08-05 19:58:53 +0000111
Guido van Rossumb6775db1994-08-01 11:34:53 +0000112#endif /* !WITH_THREAD */
Guido van Rossuma3309961993-07-28 09:05:47 +0000113
Fred Drake5eb6d4e2000-07-08 23:37:28 +0000114extern DL_IMPORT(int) _PyEval_SliceIndex(PyObject *, int *);
Guido van Rossum7c36ada2000-05-08 14:04:54 +0000115
116
Guido van Rossuma3309961993-07-28 09:05:47 +0000117#ifdef __cplusplus
118}
119#endif
120#endif /* !Py_CEVAL_H */