Mercurial > cpython-lru_cache-weakref

annotate Include/ceval.h @ 4566:6403c94de50d legacy-trunk

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Added safeguard against failure in __del__.
author Guido van Rossum <guido@python.org>
date Wed, 27 Nov 1996 19:39:58 +0000
parents 65d2d8e67da3
children 85980ea5e805
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1329
519c25039c6a * Added support for X11 modules.
Guido van Rossum <guido@python.org>
parents: 1293
diff changeset
1 #ifndef Py_CEVAL_H
519c25039c6a * Added support for X11 modules.
Guido van Rossum <guido@python.org>
parents: 1293
diff changeset
2 #define Py_CEVAL_H
519c25039c6a * Added support for X11 modules.
Guido van Rossum <guido@python.org>
parents: 1293
diff changeset
3 #ifdef __cplusplus
519c25039c6a * Added support for X11 modules.
Guido van Rossum <guido@python.org>
parents: 1293
diff changeset
4 extern "C" {
519c25039c6a * Added support for X11 modules.
Guido van Rossum <guido@python.org>
parents: 1293
diff changeset
5 #endif
519c25039c6a * Added support for X11 modules.
Guido van Rossum <guido@python.org>
parents: 1293
diff changeset
6
145
853b736a6a9e Added copyright notice.
Guido van Rossum <guido@python.org>
parents: 86
diff changeset
7 /***********************************************************
2058
508036dbba3b Added 1995 copyright.
Guido van Rossum <guido@python.org>
parents: 2043
diff changeset
8 Copyright 1991-1995 by Stichting Mathematisch Centrum, Amsterdam,
508036dbba3b Added 1995 copyright.
Guido van Rossum <guido@python.org>
parents: 2043
diff changeset
9 The Netherlands.
145
853b736a6a9e Added copyright notice.
Guido van Rossum <guido@python.org>
parents: 86
diff changeset
10
853b736a6a9e Added copyright notice.
Guido van Rossum <guido@python.org>
parents: 86
diff changeset
11 All Rights Reserved
853b736a6a9e Added copyright notice.
Guido van Rossum <guido@python.org>
parents: 86
diff changeset
12
4503
65d2d8e67da3 New permission notice, includes CNRI.
Guido van Rossum <guido@python.org>
parents: 2841
diff changeset
13 Permission to use, copy, modify, and distribute this software and its
65d2d8e67da3 New permission notice, includes CNRI.
Guido van Rossum <guido@python.org>
parents: 2841
diff changeset
14 documentation for any purpose and without fee is hereby granted,
145
853b736a6a9e Added copyright notice.
Guido van Rossum <guido@python.org>
parents: 86
diff changeset
15 provided that the above copyright notice appear in all copies and that
4503
65d2d8e67da3 New permission notice, includes CNRI.
Guido van Rossum <guido@python.org>
parents: 2841
diff changeset
16 both that copyright notice and this permission notice appear in
145
853b736a6a9e Added copyright notice.
Guido van Rossum <guido@python.org>
parents: 86
diff changeset
17 supporting documentation, and that the names of Stichting Mathematisch
4503
65d2d8e67da3 New permission notice, includes CNRI.
Guido van Rossum <guido@python.org>
parents: 2841
diff changeset
18 Centrum or CWI or Corporation for National Research Initiatives or
65d2d8e67da3 New permission notice, includes CNRI.
Guido van Rossum <guido@python.org>
parents: 2841
diff changeset
19 CNRI not be used in advertising or publicity pertaining to
65d2d8e67da3 New permission notice, includes CNRI.
Guido van Rossum <guido@python.org>
parents: 2841
diff changeset
20 distribution of the software without specific, written prior
65d2d8e67da3 New permission notice, includes CNRI.
Guido van Rossum <guido@python.org>
parents: 2841
diff changeset
21 permission.
145
853b736a6a9e Added copyright notice.
Guido van Rossum <guido@python.org>
parents: 86
diff changeset
22
4503
65d2d8e67da3 New permission notice, includes CNRI.
Guido van Rossum <guido@python.org>
parents: 2841
diff changeset
23 While CWI is the initial source for this software, a modified version
65d2d8e67da3 New permission notice, includes CNRI.
Guido van Rossum <guido@python.org>
parents: 2841
diff changeset
24 is made available by the Corporation for National Research Initiatives
65d2d8e67da3 New permission notice, includes CNRI.
Guido van Rossum <guido@python.org>
parents: 2841
diff changeset
25 (CNRI) at the Internet address ftp://ftp.python.org.
65d2d8e67da3 New permission notice, includes CNRI.
Guido van Rossum <guido@python.org>
parents: 2841
diff changeset
26
65d2d8e67da3 New permission notice, includes CNRI.
Guido van Rossum <guido@python.org>
parents: 2841
diff changeset
27 STICHTING MATHEMATISCH CENTRUM AND CNRI DISCLAIM ALL WARRANTIES WITH
65d2d8e67da3 New permission notice, includes CNRI.
Guido van Rossum <guido@python.org>
parents: 2841
diff changeset
28 REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF
65d2d8e67da3 New permission notice, includes CNRI.
Guido van Rossum <guido@python.org>
parents: 2841
diff changeset
29 MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL STICHTING MATHEMATISCH
65d2d8e67da3 New permission notice, includes CNRI.
Guido van Rossum <guido@python.org>
parents: 2841
diff changeset
30 CENTRUM OR CNRI BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL
65d2d8e67da3 New permission notice, includes CNRI.
Guido van Rossum <guido@python.org>
parents: 2841
diff changeset
31 DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
65d2d8e67da3 New permission notice, includes CNRI.
Guido van Rossum <guido@python.org>
parents: 2841
diff changeset
32 PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
65d2d8e67da3 New permission notice, includes CNRI.
Guido van Rossum <guido@python.org>
parents: 2841
diff changeset
33 TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
65d2d8e67da3 New permission notice, includes CNRI.
Guido van Rossum <guido@python.org>
parents: 2841
diff changeset
34 PERFORMANCE OF THIS SOFTWARE.
145
853b736a6a9e Added copyright notice.
Guido van Rossum <guido@python.org>
parents: 86
diff changeset
35
853b736a6a9e Added copyright notice.
Guido van Rossum <guido@python.org>
parents: 86
diff changeset
36 ******************************************************************/
853b736a6a9e Added copyright notice.
Guido van Rossum <guido@python.org>
parents: 86
diff changeset
37
926
c156d4960c2b * Makefile: cosmetics
Guido van Rossum <guido@python.org>
parents: 790
diff changeset
38 /* Interface to random parts in ceval.c */
86
a6934380c6e7 "Compiling" version
Guido van Rossum <guido@python.org>
parents:
diff changeset
39
2129
05360cd616ae The great renaming, phase two: all header files have been updated to
Guido van Rossum <guido@python.org>
parents: 2098
diff changeset
40 PyObject *PyEval_CallObject Py_PROTO((PyObject *, PyObject *));
2841
64928f6a8e80 keyword arguments and faster function calls
Guido van Rossum <guido@python.org>
parents: 2129
diff changeset
41 PyObject *PyEval_CallObjectWithKeywords
64928f6a8e80 keyword arguments and faster function calls
Guido van Rossum <guido@python.org>
parents: 2129
diff changeset
42 Py_PROTO((PyObject *, PyObject *, PyObject *));
315
aef7e0a9119e Added call_object interface
Guido van Rossum <guido@python.org>
parents: 145
diff changeset
43
2129
05360cd616ae The great renaming, phase two: all header files have been updated to
Guido van Rossum <guido@python.org>
parents: 2098
diff changeset
44 PyObject *PyEval_GetBuiltins Py_PROTO((void));
05360cd616ae The great renaming, phase two: all header files have been updated to
Guido van Rossum <guido@python.org>
parents: 2098
diff changeset
45 PyObject *PyEval_GetGlobals Py_PROTO((void));
05360cd616ae The great renaming, phase two: all header files have been updated to
Guido van Rossum <guido@python.org>
parents: 2098
diff changeset
46 PyObject *PyEval_GetLocals Py_PROTO((void));
05360cd616ae The great renaming, phase two: all header files have been updated to
Guido van Rossum <guido@python.org>
parents: 2098
diff changeset
47 PyObject *PyEval_GetOwner Py_PROTO((void));
05360cd616ae The great renaming, phase two: all header files have been updated to
Guido van Rossum <guido@python.org>
parents: 2098
diff changeset
48 PyObject *PyEval_GetFrame Py_PROTO((void));
05360cd616ae The great renaming, phase two: all header files have been updated to
Guido van Rossum <guido@python.org>
parents: 2098
diff changeset
49 int PyEval_GetRestricted Py_PROTO((void));
86
a6934380c6e7 "Compiling" version
Guido van Rossum <guido@python.org>
parents:
diff changeset
50
2129
05360cd616ae The great renaming, phase two: all header files have been updated to
Guido van Rossum <guido@python.org>
parents: 2098
diff changeset
51 void Py_FlushLine Py_PROTO((void));
926
c156d4960c2b * Makefile: cosmetics
Guido van Rossum <guido@python.org>
parents: 790
diff changeset
52
2129
05360cd616ae The great renaming, phase two: all header files have been updated to
Guido van Rossum <guido@python.org>
parents: 2098
diff changeset
53 int Py_AddPendingCall Py_PROTO((int (*func) Py_PROTO((ANY *)), ANY *arg));
05360cd616ae The great renaming, phase two: all header files have been updated to
Guido van Rossum <guido@python.org>
parents: 2098
diff changeset
54 int Py_MakePendingCalls Py_PROTO((void));
1885
d3de2cad2c68 pythonrun.h: added run_pyc_file
Guido van Rossum <guido@python.org>
parents: 1746
diff changeset
55
926
c156d4960c2b * Makefile: cosmetics
Guido van Rossum <guido@python.org>
parents: 790
diff changeset
56
c156d4960c2b * Makefile: cosmetics
Guido van Rossum <guido@python.org>
parents: 790
diff changeset
57 /* Interface for threads.
c156d4960c2b * Makefile: cosmetics
Guido van Rossum <guido@python.org>
parents: 790
diff changeset
58
c156d4960c2b * Makefile: cosmetics
Guido van Rossum <guido@python.org>
parents: 790
diff changeset
59 A module that plans to do a blocking system call (or something else
c156d4960c2b * Makefile: cosmetics
Guido van Rossum <guido@python.org>
parents: 790
diff changeset
60 that lasts a long time and doesn't touch Python data) can allow other
c156d4960c2b * Makefile: cosmetics
Guido van Rossum <guido@python.org>
parents: 790
diff changeset
61 threads to run as follows:
c156d4960c2b * Makefile: cosmetics
Guido van Rossum <guido@python.org>
parents: 790
diff changeset
62
c156d4960c2b * Makefile: cosmetics
Guido van Rossum <guido@python.org>
parents: 790
diff changeset
63 ...preparations here...
2129
05360cd616ae The great renaming, phase two: all header files have been updated to
Guido van Rossum <guido@python.org>
parents: 2098
diff changeset
64 Py_BEGIN_ALLOW_THREADS
926
c156d4960c2b * Makefile: cosmetics
Guido van Rossum <guido@python.org>
parents: 790
diff changeset
65 ...blocking system call here...
2129
05360cd616ae The great renaming, phase two: all header files have been updated to
Guido van Rossum <guido@python.org>
parents: 2098
diff changeset
66 Py_END_ALLOW_THREADS
2043
4ebee904924e Lots of small things, see ChangeLog
Guido van Rossum <guido@python.org>
parents: 1906
diff changeset
67 ...interpret result here...
926
c156d4960c2b * Makefile: cosmetics
Guido van Rossum <guido@python.org>
parents: 790
diff changeset
68
2129
05360cd616ae The great renaming, phase two: all header files have been updated to
Guido van Rossum <guido@python.org>
parents: 2098
diff changeset
69 The Py_BEGIN_ALLOW_THREADS/Py_END_ALLOW_THREADS pair expands to a
05360cd616ae The great renaming, phase two: all header files have been updated to
Guido van Rossum <guido@python.org>
parents: 2098
diff changeset
70 {}-surrounded block.
926
c156d4960c2b * Makefile: cosmetics
Guido van Rossum <guido@python.org>
parents: 790
diff changeset
71 To leave the block in the middle (e.g., with return), you must insert
c156d4960c2b * Makefile: cosmetics
Guido van Rossum <guido@python.org>
parents: 790
diff changeset
72 a line containing RET_SAVE before the return, e.g.
c156d4960c2b * Makefile: cosmetics
Guido van Rossum <guido@python.org>
parents: 790
diff changeset
73
c156d4960c2b * Makefile: cosmetics
Guido van Rossum <guido@python.org>
parents: 790
diff changeset
74 if (...premature_exit...) {
2129
05360cd616ae The great renaming, phase two: all header files have been updated to
Guido van Rossum <guido@python.org>
parents: 2098
diff changeset
75 Py_BLOCK_THREADS
05360cd616ae The great renaming, phase two: all header files have been updated to
Guido van Rossum <guido@python.org>
parents: 2098
diff changeset
76 PyErr_SetFromErrno(PyExc_IOError);
926
c156d4960c2b * Makefile: cosmetics
Guido van Rossum <guido@python.org>
parents: 790
diff changeset
77 return NULL;
c156d4960c2b * Makefile: cosmetics
Guido van Rossum <guido@python.org>
parents: 790
diff changeset
78 }
c156d4960c2b * Makefile: cosmetics
Guido van Rossum <guido@python.org>
parents: 790
diff changeset
79
c156d4960c2b * Makefile: cosmetics
Guido van Rossum <guido@python.org>
parents: 790
diff changeset
80 An alternative is:
c156d4960c2b * Makefile: cosmetics
Guido van Rossum <guido@python.org>
parents: 790
diff changeset
81
2129
05360cd616ae The great renaming, phase two: all header files have been updated to
Guido van Rossum <guido@python.org>
parents: 2098
diff changeset
82 Py_BLOCK_THREADS
926
c156d4960c2b * Makefile: cosmetics
Guido van Rossum <guido@python.org>
parents: 790
diff changeset
83 if (...premature_exit...) {
2129
05360cd616ae The great renaming, phase two: all header files have been updated to
Guido van Rossum <guido@python.org>
parents: 2098
diff changeset
84 PyErr_SetFromErrno(PyExc_IOError);
926
c156d4960c2b * Makefile: cosmetics
Guido van Rossum <guido@python.org>
parents: 790
diff changeset
85 return NULL;
c156d4960c2b * Makefile: cosmetics
Guido van Rossum <guido@python.org>
parents: 790
diff changeset
86 }
2129
05360cd616ae The great renaming, phase two: all header files have been updated to
Guido van Rossum <guido@python.org>
parents: 2098
diff changeset
87 Py_UNBLOCK_THREADS
926
c156d4960c2b * Makefile: cosmetics
Guido van Rossum <guido@python.org>
parents: 790
diff changeset
88
c156d4960c2b * Makefile: cosmetics
Guido van Rossum <guido@python.org>
parents: 790
diff changeset
89 For convenience, that the value of 'errno' is restored across
2129
05360cd616ae The great renaming, phase two: all header files have been updated to
Guido van Rossum <guido@python.org>
parents: 2098
diff changeset
90 Py_END_ALLOW_THREADS and RET_SAVE.
926
c156d4960c2b * Makefile: cosmetics
Guido van Rossum <guido@python.org>
parents: 790
diff changeset
91
2129
05360cd616ae The great renaming, phase two: all header files have been updated to
Guido van Rossum <guido@python.org>
parents: 2098
diff changeset
92 WARNING: NEVER NEST CALLS TO Py_BEGIN_ALLOW_THREADS AND
05360cd616ae The great renaming, phase two: all header files have been updated to
Guido van Rossum <guido@python.org>
parents: 2098
diff changeset
93 Py_END_ALLOW_THREADS!!!
926
c156d4960c2b * Makefile: cosmetics
Guido van Rossum <guido@python.org>
parents: 790
diff changeset
94
2129
05360cd616ae The great renaming, phase two: all header files have been updated to
Guido van Rossum <guido@python.org>
parents: 2098
diff changeset
95 The function PyEval_InitThreads() should be called only from
926
c156d4960c2b * Makefile: cosmetics
Guido van Rossum <guido@python.org>
parents: 790
diff changeset
96 initthread() in "threadmodule.c".
c156d4960c2b * Makefile: cosmetics
Guido van Rossum <guido@python.org>
parents: 790
diff changeset
97
c156d4960c2b * Makefile: cosmetics
Guido van Rossum <guido@python.org>
parents: 790
diff changeset
98 Note that not yet all candidates have been converted to use this
c156d4960c2b * Makefile: cosmetics
Guido van Rossum <guido@python.org>
parents: 790
diff changeset
99 mechanism!
c156d4960c2b * Makefile: cosmetics
Guido van Rossum <guido@python.org>
parents: 790
diff changeset
100 */
c156d4960c2b * Makefile: cosmetics
Guido van Rossum <guido@python.org>
parents: 790
diff changeset
101
2129
05360cd616ae The great renaming, phase two: all header files have been updated to
Guido van Rossum <guido@python.org>
parents: 2098
diff changeset
102 extern void PyEval_InitThreads Py_PROTO((void));
05360cd616ae The great renaming, phase two: all header files have been updated to
Guido van Rossum <guido@python.org>
parents: 2098
diff changeset
103 extern PyObject *PyEval_SaveThread Py_PROTO((void));
05360cd616ae The great renaming, phase two: all header files have been updated to
Guido van Rossum <guido@python.org>
parents: 2098
diff changeset
104 extern void PyEval_RestoreThread Py_PROTO((PyObject *));
926
c156d4960c2b * Makefile: cosmetics
Guido van Rossum <guido@python.org>
parents: 790
diff changeset
105
1746
1940892d2fe3 Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1391
diff changeset
106 #ifdef WITH_THREAD
926
c156d4960c2b * Makefile: cosmetics
Guido van Rossum <guido@python.org>
parents: 790
diff changeset
107
2129
05360cd616ae The great renaming, phase two: all header files have been updated to
Guido van Rossum <guido@python.org>
parents: 2098
diff changeset
108 #define Py_BEGIN_ALLOW_THREADS { \
05360cd616ae The great renaming, phase two: all header files have been updated to
Guido van Rossum <guido@python.org>
parents: 2098
diff changeset
109 PyObject *_save; \
05360cd616ae The great renaming, phase two: all header files have been updated to
Guido van Rossum <guido@python.org>
parents: 2098
diff changeset
110 _save = PyEval_SaveThread();
05360cd616ae The great renaming, phase two: all header files have been updated to
Guido van Rossum <guido@python.org>
parents: 2098
diff changeset
111 #define Py_BLOCK_THREADS PyEval_RestoreThread(_save);
05360cd616ae The great renaming, phase two: all header files have been updated to
Guido van Rossum <guido@python.org>
parents: 2098
diff changeset
112 #define Py_UNBLOCK_THREADS _save = PyEval_SaveThread();
05360cd616ae The great renaming, phase two: all header files have been updated to
Guido van Rossum <guido@python.org>
parents: 2098
diff changeset
113 #define Py_END_ALLOW_THREADS PyEval_RestoreThread(_save); \
926
c156d4960c2b * Makefile: cosmetics
Guido van Rossum <guido@python.org>
parents: 790
diff changeset
114 }
c156d4960c2b * Makefile: cosmetics
Guido van Rossum <guido@python.org>
parents: 790
diff changeset
115
1746
1940892d2fe3 Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1391
diff changeset
116 #else /* !WITH_THREAD */
926
c156d4960c2b * Makefile: cosmetics
Guido van Rossum <guido@python.org>
parents: 790
diff changeset
117
2129
05360cd616ae The great renaming, phase two: all header files have been updated to
Guido van Rossum <guido@python.org>
parents: 2098
diff changeset
118 #define Py_BEGIN_ALLOW_THREADS {
05360cd616ae The great renaming, phase two: all header files have been updated to
Guido van Rossum <guido@python.org>
parents: 2098
diff changeset
119 #define Py_BLOCK_THREADS
05360cd616ae The great renaming, phase two: all header files have been updated to
Guido van Rossum <guido@python.org>
parents: 2098
diff changeset
120 #define Py_UNBLOCK_THREADS
05360cd616ae The great renaming, phase two: all header files have been updated to
Guido van Rossum <guido@python.org>
parents: 2098
diff changeset
121 #define Py_END_ALLOW_THREADS }
926
c156d4960c2b * Makefile: cosmetics
Guido van Rossum <guido@python.org>
parents: 790
diff changeset
122
1746
1940892d2fe3 Merge alpha100 branch back to main trunk
Guido van Rossum <guido@python.org>
parents: 1391
diff changeset
123 #endif /* !WITH_THREAD */
1329
519c25039c6a * Added support for X11 modules.
Guido van Rossum <guido@python.org>
parents: 1293
diff changeset
124
519c25039c6a * Added support for X11 modules.
Guido van Rossum <guido@python.org>
parents: 1293
diff changeset
125 #ifdef __cplusplus
519c25039c6a * Added support for X11 modules.
Guido van Rossum <guido@python.org>
parents: 1293
diff changeset
126 }
519c25039c6a * Added support for X11 modules.
Guido van Rossum <guido@python.org>
parents: 1293
diff changeset
127 #endif
519c25039c6a * Added support for X11 modules.
Guido van Rossum <guido@python.org>
parents: 1293
diff changeset
128 #endif /* !Py_CEVAL_H */