annotate Include/opcode.h @ 892:11ea669c231e legacy-trunk

Documented new contents of lib5.tex
author Guido van Rossum <guido@python.org>
date Wed, 03 Jun 1992 17:56:44 +0000
parents 164849f56105
children 1cabc2b6c970
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
145
853b736a6a9e Added copyright notice.
Guido van Rossum <guido@python.org>
parents: 86
diff changeset
1 /***********************************************************
790
164849f56105 Copyright for 1992 added
Guido van Rossum <guido@python.org>
parents: 592
diff changeset
2 Copyright 1991, 1992 by Stichting Mathematisch Centrum, Amsterdam, The
145
853b736a6a9e Added copyright notice.
Guido van Rossum <guido@python.org>
parents: 86
diff changeset
3 Netherlands.
853b736a6a9e Added copyright notice.
Guido van Rossum <guido@python.org>
parents: 86
diff changeset
4
853b736a6a9e Added copyright notice.
Guido van Rossum <guido@python.org>
parents: 86
diff changeset
5 All Rights Reserved
853b736a6a9e Added copyright notice.
Guido van Rossum <guido@python.org>
parents: 86
diff changeset
6
853b736a6a9e Added copyright notice.
Guido van Rossum <guido@python.org>
parents: 86
diff changeset
7 Permission to use, copy, modify, and distribute this software and its
853b736a6a9e Added copyright notice.
Guido van Rossum <guido@python.org>
parents: 86
diff changeset
8 documentation for any purpose and without fee is hereby granted,
853b736a6a9e Added copyright notice.
Guido van Rossum <guido@python.org>
parents: 86
diff changeset
9 provided that the above copyright notice appear in all copies and that
853b736a6a9e Added copyright notice.
Guido van Rossum <guido@python.org>
parents: 86
diff changeset
10 both that copyright notice and this permission notice appear in
853b736a6a9e Added copyright notice.
Guido van Rossum <guido@python.org>
parents: 86
diff changeset
11 supporting documentation, and that the names of Stichting Mathematisch
853b736a6a9e Added copyright notice.
Guido van Rossum <guido@python.org>
parents: 86
diff changeset
12 Centrum or CWI not be used in advertising or publicity pertaining to
853b736a6a9e Added copyright notice.
Guido van Rossum <guido@python.org>
parents: 86
diff changeset
13 distribution of the software without specific, written prior permission.
853b736a6a9e Added copyright notice.
Guido van Rossum <guido@python.org>
parents: 86
diff changeset
14
853b736a6a9e Added copyright notice.
Guido van Rossum <guido@python.org>
parents: 86
diff changeset
15 STICHTING MATHEMATISCH CENTRUM DISCLAIMS ALL WARRANTIES WITH REGARD TO
853b736a6a9e Added copyright notice.
Guido van Rossum <guido@python.org>
parents: 86
diff changeset
16 THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
853b736a6a9e Added copyright notice.
Guido van Rossum <guido@python.org>
parents: 86
diff changeset
17 FITNESS, IN NO EVENT SHALL STICHTING MATHEMATISCH CENTRUM BE LIABLE
853b736a6a9e Added copyright notice.
Guido van Rossum <guido@python.org>
parents: 86
diff changeset
18 FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
853b736a6a9e Added copyright notice.
Guido van Rossum <guido@python.org>
parents: 86
diff changeset
19 WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
853b736a6a9e Added copyright notice.
Guido van Rossum <guido@python.org>
parents: 86
diff changeset
20 ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
853b736a6a9e Added copyright notice.
Guido van Rossum <guido@python.org>
parents: 86
diff changeset
21 OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
853b736a6a9e Added copyright notice.
Guido van Rossum <guido@python.org>
parents: 86
diff changeset
22
853b736a6a9e Added copyright notice.
Guido van Rossum <guido@python.org>
parents: 86
diff changeset
23 ******************************************************************/
853b736a6a9e Added copyright notice.
Guido van Rossum <guido@python.org>
parents: 86
diff changeset
24
69
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
25 /* Instruction opcodes for compiled code */
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
26
86
a6934380c6e7 "Compiling" version
Guido van Rossum <guido@python.org>
parents: 78
diff changeset
27 #define STOP_CODE 0
69
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
28 #define POP_TOP 1
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
29 #define ROT_TWO 2
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
30 #define ROT_THREE 3
86
a6934380c6e7 "Compiling" version
Guido van Rossum <guido@python.org>
parents: 78
diff changeset
31 #define DUP_TOP 4
69
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
32
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
33 #define UNARY_POSITIVE 10
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
34 #define UNARY_NEGATIVE 11
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
35 #define UNARY_NOT 12
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
36 #define UNARY_CONVERT 13
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
37 #define UNARY_CALL 14
409
b5fe6482072f Added shift and mask ops.
Guido van Rossum <guido@python.org>
parents: 178
diff changeset
38 #define UNARY_INVERT 15
69
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
39
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
40 #define BINARY_MULTIPLY 20
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
41 #define BINARY_DIVIDE 21
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
42 #define BINARY_MODULO 22
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
43 #define BINARY_ADD 23
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
44 #define BINARY_SUBTRACT 24
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
45 #define BINARY_SUBSCR 25
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
46 #define BINARY_CALL 26
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
47
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
48 #define SLICE 30
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
49 /* Also uses 31-33 */
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
50
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
51 #define STORE_SLICE 40
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
52 /* Also uses 41-43 */
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
53
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
54 #define DELETE_SLICE 50
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
55 /* Also uses 51-53 */
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
56
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
57 #define STORE_SUBSCR 60
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
58 #define DELETE_SUBSCR 61
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
59
409
b5fe6482072f Added shift and mask ops.
Guido van Rossum <guido@python.org>
parents: 178
diff changeset
60 #define BINARY_LSHIFT 62
b5fe6482072f Added shift and mask ops.
Guido van Rossum <guido@python.org>
parents: 178
diff changeset
61 #define BINARY_RSHIFT 63
b5fe6482072f Added shift and mask ops.
Guido van Rossum <guido@python.org>
parents: 178
diff changeset
62 #define BINARY_AND 64
b5fe6482072f Added shift and mask ops.
Guido van Rossum <guido@python.org>
parents: 178
diff changeset
63 #define BINARY_XOR 65
b5fe6482072f Added shift and mask ops.
Guido van Rossum <guido@python.org>
parents: 178
diff changeset
64 #define BINARY_OR 66
b5fe6482072f Added shift and mask ops.
Guido van Rossum <guido@python.org>
parents: 178
diff changeset
65
b5fe6482072f Added shift and mask ops.
Guido van Rossum <guido@python.org>
parents: 178
diff changeset
66
69
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
67 #define PRINT_EXPR 70
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
68 #define PRINT_ITEM 71
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
69 #define PRINT_NEWLINE 72
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
70
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
71 #define BREAK_LOOP 80
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
72 #define RAISE_EXCEPTION 81
78
b1fb4e1f6e51 Added opcodes for classes.
Guido van Rossum <guido@python.org>
parents: 69
diff changeset
73 #define LOAD_LOCALS 82
69
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
74 #define RETURN_VALUE 83
489
a0fbc7b6a485 Added UNPACK_ARG.
Guido van Rossum <guido@python.org>
parents: 474
diff changeset
75 /*
69
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
76 #define REQUIRE_ARGS 84
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
77 #define REFUSE_ARGS 85
489
a0fbc7b6a485 Added UNPACK_ARG.
Guido van Rossum <guido@python.org>
parents: 474
diff changeset
78 */
69
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
79 #define BUILD_FUNCTION 86
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
80 #define POP_BLOCK 87
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
81 #define END_FINALLY 88
78
b1fb4e1f6e51 Added opcodes for classes.
Guido van Rossum <guido@python.org>
parents: 69
diff changeset
82 #define BUILD_CLASS 89
69
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
83
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
84 #define HAVE_ARGUMENT 90 /* Opcodes from here have an argument: */
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
85
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
86 #define STORE_NAME 90 /* Index in name list */
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
87 #define DELETE_NAME 91 /* "" */
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
88 #define UNPACK_TUPLE 92 /* Number of tuple items */
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
89 #define UNPACK_LIST 93 /* Number of list items */
489
a0fbc7b6a485 Added UNPACK_ARG.
Guido van Rossum <guido@python.org>
parents: 474
diff changeset
90 #define UNPACK_ARG 94 /* Number of arguments */
69
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
91 #define STORE_ATTR 95 /* Index in name list */
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
92 #define DELETE_ATTR 96 /* "" */
474
19365201dcfa Added _GLOBAL opcodes.
Guido van Rossum <guido@python.org>
parents: 409
diff changeset
93 #define STORE_GLOBAL 97 /* "" */
19365201dcfa Added _GLOBAL opcodes.
Guido van Rossum <guido@python.org>
parents: 409
diff changeset
94 #define DELETE_GLOBAL 98 /* "" */
592
9572a7d09dff Added UNPACK_VARARG.
Guido van Rossum <guido@python.org>
parents: 489
diff changeset
95 #define UNPACK_VARARG 99 /* Minimal number of arguments */
69
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
96
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
97 #define LOAD_CONST 100 /* Index in const list */
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
98 #define LOAD_NAME 101 /* Index in name list */
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
99 #define BUILD_TUPLE 102 /* Number of tuple items */
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
100 #define BUILD_LIST 103 /* Number of list items */
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
101 #define BUILD_MAP 104 /* Always zero for now */
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
102 #define LOAD_ATTR 105 /* Index in name list */
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
103 #define COMPARE_OP 106 /* Comparison operator */
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
104 #define IMPORT_NAME 107 /* Index in name list */
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
105 #define IMPORT_FROM 108 /* Index in name list */
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
106
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
107 #define JUMP_FORWARD 110 /* Number of bytes to skip */
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
108 #define JUMP_IF_FALSE 111 /* "" */
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
109 #define JUMP_IF_TRUE 112 /* "" */
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
110 #define JUMP_ABSOLUTE 113 /* Target byte offset from beginning of code */
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
111 #define FOR_LOOP 114 /* Number of bytes to skip */
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
112
178
fb6367d5ff46 Added opcodes to load local/global variables
Guido van Rossum <guido@python.org>
parents: 145
diff changeset
113 #define LOAD_LOCAL 115 /* Index in name list */
fb6367d5ff46 Added opcodes to load local/global variables
Guido van Rossum <guido@python.org>
parents: 145
diff changeset
114 #define LOAD_GLOBAL 116 /* Index in name list */
fb6367d5ff46 Added opcodes to load local/global variables
Guido van Rossum <guido@python.org>
parents: 145
diff changeset
115
69
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
116 #define SETUP_LOOP 120 /* Target address (absolute) */
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
117 #define SETUP_EXCEPT 121 /* "" */
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
118 #define SETUP_FINALLY 122 /* "" */
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
119
86
a6934380c6e7 "Compiling" version
Guido van Rossum <guido@python.org>
parents: 78
diff changeset
120 #define SET_LINENO 127 /* Current line number */
a6934380c6e7 "Compiling" version
Guido van Rossum <guido@python.org>
parents: 78
diff changeset
121
69
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
122 /* Comparison operator codes (argument to COMPARE_OP) */
cccd534f2280 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
123 enum cmp_op {LT, LE, EQ, NE, GT, GE, IN, NOT_IN, IS, IS_NOT, EXC_MATCH, BAD};
86
a6934380c6e7 "Compiling" version
Guido van Rossum <guido@python.org>
parents: 78
diff changeset
124
a6934380c6e7 "Compiling" version
Guido van Rossum <guido@python.org>
parents: 78
diff changeset
125 #define HAS_ARG(op) ((op) >= HAVE_ARGUMENT)