• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1
2"""
3opcode module - potentially shared between dis and other modules which
4operate on bytecodes (e.g. peephole optimizers).
5"""
6
7__all__ = ["cmp_op", "hasconst", "hasname", "hasjrel", "hasjabs",
8           "haslocal", "hascompare", "hasfree", "opname", "opmap",
9           "HAVE_ARGUMENT", "EXTENDED_ARG"]
10
11cmp_op = ('<', '<=', '==', '!=', '>', '>=', 'in', 'not in', 'is',
12        'is not', 'exception match', 'BAD')
13
14hasconst = []
15hasname = []
16hasjrel = []
17hasjabs = []
18haslocal = []
19hascompare = []
20hasfree = []
21
22opmap = {}
23opname = [''] * 256
24for op in range(256): opname[op] = '<%r>' % (op,)
25del op
26
27def def_op(name, op):
28    opname[op] = name
29    opmap[name] = op
30
31def name_op(name, op):
32    def_op(name, op)
33    hasname.append(op)
34
35def jrel_op(name, op):
36    def_op(name, op)
37    hasjrel.append(op)
38
39def jabs_op(name, op):
40    def_op(name, op)
41    hasjabs.append(op)
42
43# Instruction opcodes for compiled code
44# Blank lines correspond to available opcodes
45
46def_op('STOP_CODE', 0)
47def_op('POP_TOP', 1)
48def_op('ROT_TWO', 2)
49def_op('ROT_THREE', 3)
50def_op('DUP_TOP', 4)
51def_op('ROT_FOUR', 5)
52
53def_op('NOP', 9)
54def_op('UNARY_POSITIVE', 10)
55def_op('UNARY_NEGATIVE', 11)
56def_op('UNARY_NOT', 12)
57def_op('UNARY_CONVERT', 13)
58
59def_op('UNARY_INVERT', 15)
60
61def_op('BINARY_POWER', 19)
62def_op('BINARY_MULTIPLY', 20)
63def_op('BINARY_DIVIDE', 21)
64def_op('BINARY_MODULO', 22)
65def_op('BINARY_ADD', 23)
66def_op('BINARY_SUBTRACT', 24)
67def_op('BINARY_SUBSCR', 25)
68def_op('BINARY_FLOOR_DIVIDE', 26)
69def_op('BINARY_TRUE_DIVIDE', 27)
70def_op('INPLACE_FLOOR_DIVIDE', 28)
71def_op('INPLACE_TRUE_DIVIDE', 29)
72def_op('SLICE+0', 30)
73def_op('SLICE+1', 31)
74def_op('SLICE+2', 32)
75def_op('SLICE+3', 33)
76
77def_op('STORE_SLICE+0', 40)
78def_op('STORE_SLICE+1', 41)
79def_op('STORE_SLICE+2', 42)
80def_op('STORE_SLICE+3', 43)
81
82def_op('DELETE_SLICE+0', 50)
83def_op('DELETE_SLICE+1', 51)
84def_op('DELETE_SLICE+2', 52)
85def_op('DELETE_SLICE+3', 53)
86
87def_op('STORE_MAP', 54)
88def_op('INPLACE_ADD', 55)
89def_op('INPLACE_SUBTRACT', 56)
90def_op('INPLACE_MULTIPLY', 57)
91def_op('INPLACE_DIVIDE', 58)
92def_op('INPLACE_MODULO', 59)
93def_op('STORE_SUBSCR', 60)
94def_op('DELETE_SUBSCR', 61)
95def_op('BINARY_LSHIFT', 62)
96def_op('BINARY_RSHIFT', 63)
97def_op('BINARY_AND', 64)
98def_op('BINARY_XOR', 65)
99def_op('BINARY_OR', 66)
100def_op('INPLACE_POWER', 67)
101def_op('GET_ITER', 68)
102
103def_op('PRINT_EXPR', 70)
104def_op('PRINT_ITEM', 71)
105def_op('PRINT_NEWLINE', 72)
106def_op('PRINT_ITEM_TO', 73)
107def_op('PRINT_NEWLINE_TO', 74)
108def_op('INPLACE_LSHIFT', 75)
109def_op('INPLACE_RSHIFT', 76)
110def_op('INPLACE_AND', 77)
111def_op('INPLACE_XOR', 78)
112def_op('INPLACE_OR', 79)
113def_op('BREAK_LOOP', 80)
114def_op('WITH_CLEANUP', 81)
115def_op('LOAD_LOCALS', 82)
116def_op('RETURN_VALUE', 83)
117def_op('IMPORT_STAR', 84)
118def_op('EXEC_STMT', 85)
119def_op('YIELD_VALUE', 86)
120def_op('POP_BLOCK', 87)
121def_op('END_FINALLY', 88)
122def_op('BUILD_CLASS', 89)
123
124HAVE_ARGUMENT = 90              # Opcodes from here have an argument:
125
126name_op('STORE_NAME', 90)       # Index in name list
127name_op('DELETE_NAME', 91)      # ""
128def_op('UNPACK_SEQUENCE', 92)   # Number of tuple items
129jrel_op('FOR_ITER', 93)
130def_op('LIST_APPEND', 94)
131name_op('STORE_ATTR', 95)       # Index in name list
132name_op('DELETE_ATTR', 96)      # ""
133name_op('STORE_GLOBAL', 97)     # ""
134name_op('DELETE_GLOBAL', 98)    # ""
135def_op('DUP_TOPX', 99)          # number of items to duplicate
136def_op('LOAD_CONST', 100)       # Index in const list
137hasconst.append(100)
138name_op('LOAD_NAME', 101)       # Index in name list
139def_op('BUILD_TUPLE', 102)      # Number of tuple items
140def_op('BUILD_LIST', 103)       # Number of list items
141def_op('BUILD_SET', 104)        # Number of set items
142def_op('BUILD_MAP', 105)        # Number of dict entries (upto 255)
143name_op('LOAD_ATTR', 106)       # Index in name list
144def_op('COMPARE_OP', 107)       # Comparison operator
145hascompare.append(107)
146name_op('IMPORT_NAME', 108)     # Index in name list
147name_op('IMPORT_FROM', 109)     # Index in name list
148jrel_op('JUMP_FORWARD', 110)    # Number of bytes to skip
149jabs_op('JUMP_IF_FALSE_OR_POP', 111) # Target byte offset from beginning of code
150jabs_op('JUMP_IF_TRUE_OR_POP', 112)  # ""
151jabs_op('JUMP_ABSOLUTE', 113)        # ""
152jabs_op('POP_JUMP_IF_FALSE', 114)    # ""
153jabs_op('POP_JUMP_IF_TRUE', 115)     # ""
154
155name_op('LOAD_GLOBAL', 116)     # Index in name list
156
157jabs_op('CONTINUE_LOOP', 119)   # Target address
158jrel_op('SETUP_LOOP', 120)      # Distance to target address
159jrel_op('SETUP_EXCEPT', 121)    # ""
160jrel_op('SETUP_FINALLY', 122)   # ""
161
162def_op('LOAD_FAST', 124)        # Local variable number
163haslocal.append(124)
164def_op('STORE_FAST', 125)       # Local variable number
165haslocal.append(125)
166def_op('DELETE_FAST', 126)      # Local variable number
167haslocal.append(126)
168
169def_op('RAISE_VARARGS', 130)    # Number of raise arguments (1, 2, or 3)
170def_op('CALL_FUNCTION', 131)    # #args + (#kwargs << 8)
171def_op('MAKE_FUNCTION', 132)    # Number of args with default values
172def_op('BUILD_SLICE', 133)      # Number of items
173def_op('MAKE_CLOSURE', 134)
174def_op('LOAD_CLOSURE', 135)
175hasfree.append(135)
176def_op('LOAD_DEREF', 136)
177hasfree.append(136)
178def_op('STORE_DEREF', 137)
179hasfree.append(137)
180
181def_op('CALL_FUNCTION_VAR', 140)     # #args + (#kwargs << 8)
182def_op('CALL_FUNCTION_KW', 141)      # #args + (#kwargs << 8)
183def_op('CALL_FUNCTION_VAR_KW', 142)  # #args + (#kwargs << 8)
184
185jrel_op('SETUP_WITH', 143)
186
187def_op('EXTENDED_ARG', 145)
188EXTENDED_ARG = 145
189def_op('SET_ADD', 146)
190def_op('MAP_ADD', 147)
191
192del def_op, name_op, jrel_op, jabs_op
193