1#ifndef Py_CEVAL_H
2#define Py_CEVAL_H
3#ifdef __cplusplus
4extern "C" {
5#endif
6
7
8/* Interface to random parts in ceval.c */
9
10PyAPI_FUNC(PyObject *) PyEval_CallObjectWithKeywords(
11 PyObject *, PyObject *, PyObject *);
12
13/* Inline this */
14#define PyEval_CallObject(func,arg) \
15 PyEval_CallObjectWithKeywords(func, arg, (PyObject *)NULL)
16
17PyAPI_FUNC(PyObject *) PyEval_CallFunction(PyObject *obj,
18 const char *format, ...);
19PyAPI_FUNC(PyObject *) PyEval_CallMethod(PyObject *obj,
20 const char *methodname,
21 const char *format, ...);
22
23PyAPI_FUNC(void) PyEval_SetProfile(Py_tracefunc, PyObject *);
24PyAPI_FUNC(void) PyEval_SetTrace(Py_tracefunc, PyObject *);
25
26struct _frame; /* Avoid including frameobject.h */
27
28PyAPI_FUNC(PyObject *) PyEval_GetBuiltins(void);
29PyAPI_FUNC(PyObject *) PyEval_GetGlobals(void);
30PyAPI_FUNC(PyObject *) PyEval_GetLocals(void);
31PyAPI_FUNC(struct _frame *) PyEval_GetFrame(void);
32PyAPI_FUNC(int) PyEval_GetRestricted(void);
33
34/* Look at the current frame's (if any) code's co_flags, and turn on
35 the corresponding compiler flags in cf->cf_flags. Return 1 if any
36 flag was set, else return 0. */
37PyAPI_FUNC(int) PyEval_MergeCompilerFlags(PyCompilerFlags *cf);
38
39PyAPI_FUNC(int) Py_FlushLine(void);
40
41PyAPI_FUNC(int) Py_AddPendingCall(int (*func)(void *), void *arg);
42PyAPI_FUNC(int) Py_MakePendingCalls(void);
43
44/* Protection against deeply nested recursive calls */
45PyAPI_FUNC(void) Py_SetRecursionLimit(int);
46PyAPI_FUNC(int) Py_GetRecursionLimit(void);
47
48#define Py_EnterRecursiveCall(where) \
49 (_Py_MakeRecCheck(PyThreadState_GET()->recursion_depth) && \
50 _Py_CheckRecursiveCall(where))
51#define Py_LeaveRecursiveCall() \
52 (--PyThreadState_GET()->recursion_depth)
53PyAPI_FUNC(int) _Py_CheckRecursiveCall(const char *where);
54PyAPI_DATA(int) _Py_CheckRecursionLimit;
55#ifdef USE_STACKCHECK
56# define _Py_MakeRecCheck(x) (++(x) > --_Py_CheckRecursionLimit)
57#else
58# define _Py_MakeRecCheck(x) (++(x) > _Py_CheckRecursionLimit)
59#endif
60
61PyAPI_FUNC(const char *) PyEval_GetFuncName(PyObject *);
62PyAPI_FUNC(const char *) PyEval_GetFuncDesc(PyObject *);
63
64PyAPI_FUNC(PyObject *) PyEval_GetCallStats(PyObject *);
65PyAPI_FUNC(PyObject *) PyEval_EvalFrame(struct _frame *);
66PyAPI_FUNC(PyObject *) PyEval_EvalFrameEx(struct _frame *f, int exc);
67
68/* this used to be handled on a per-thread basis - now just two globals */
69PyAPI_DATA(volatile int) _Py_Ticker;
70PyAPI_DATA(int) _Py_CheckInterval;
71
72/* Interface for threads.
73
74 A module that plans to do a blocking system call (or something else
75 that lasts a long time and doesn't touch Python data) can allow other
76 threads to run as follows:
77
78 ...preparations here...
79 Py_BEGIN_ALLOW_THREADS
80 ...blocking system call here...
81 Py_END_ALLOW_THREADS
82 ...interpret result here...
83
84 The Py_BEGIN_ALLOW_THREADS/Py_END_ALLOW_THREADS pair expands to a
85 {}-surrounded block.
86 To leave the block in the middle (e.g., with return), you must insert
87 a line containing Py_BLOCK_THREADS before the return, e.g.
88
89 if (...premature_exit...) {
90 Py_BLOCK_THREADS
91 PyErr_SetFromErrno(PyExc_IOError);
92 return NULL;
93 }
94
95 An alternative is:
96
97 Py_BLOCK_THREADS
98 if (...premature_exit...) {
99 PyErr_SetFromErrno(PyExc_IOError);
100 return NULL;
101 }
102 Py_UNBLOCK_THREADS
103
104 For convenience, that the value of 'errno' is restored across
105 Py_END_ALLOW_THREADS and Py_BLOCK_THREADS.
106
107 WARNING: NEVER NEST CALLS TO Py_BEGIN_ALLOW_THREADS AND
108 Py_END_ALLOW_THREADS!!!
109
110 The function PyEval_InitThreads() should be called only from
111 initthread() in "threadmodule.c".
112
113 Note that not yet all candidates have been converted to use this
114 mechanism!
115*/
116
117PyAPI_FUNC(PyThreadState *) PyEval_SaveThread(void);
118PyAPI_FUNC(void) PyEval_RestoreThread(PyThreadState *);
119
120#ifdef WITH_THREAD
121
122PyAPI_FUNC(int) PyEval_ThreadsInitialized(void);
123PyAPI_FUNC(void) PyEval_InitThreads(void);
124PyAPI_FUNC(void) PyEval_AcquireLock(void);
125PyAPI_FUNC(void) PyEval_ReleaseLock(void);
126PyAPI_FUNC(void) PyEval_AcquireThread(PyThreadState *tstate);
127PyAPI_FUNC(void) PyEval_ReleaseThread(PyThreadState *tstate);
128PyAPI_FUNC(void) PyEval_ReInitThreads(void);
129
130#define Py_BEGIN_ALLOW_THREADS { \
131 PyThreadState *_save; \
132 _save = PyEval_SaveThread();
133#define Py_BLOCK_THREADS PyEval_RestoreThread(_save);
134#define Py_UNBLOCK_THREADS _save = PyEval_SaveThread();
135#define Py_END_ALLOW_THREADS PyEval_RestoreThread(_save); \
136 }
137
138#else /* !WITH_THREAD */
139
140#define Py_BEGIN_ALLOW_THREADS {
141#define Py_BLOCK_THREADS
142#define Py_UNBLOCK_THREADS
143#define Py_END_ALLOW_THREADS }
144
145#endif /* !WITH_THREAD */
146
147PyAPI_FUNC(int) _PyEval_SliceIndex(PyObject *, Py_ssize_t *);
148PyAPI_FUNC(int) _PyEval_SliceIndexNotNone(PyObject *, Py_ssize_t *);
149
150
151#ifdef __cplusplus
152}
153#endif
154#endif /* !Py_CEVAL_H */
155