Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / python / cpython3 / cbf3b5cb76906fba15dbf59a1e83c540a447b907 / . / Lib / opcode.py
blob: ac265834248d01459735a08876580bf9d125f1d7 [file] [log] [blame]
Skip Montanaro3249ccd2003-02-27 21:27:52 +0000[diff] [blame]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
Walter Dörwald70a6b492004-02-12 17:35:32 +0000[diff] [blame]24for op in range(256): opname[op] = '<%r>' % (op,)
Skip Montanaro3249ccd2003-02-27 21:27:52 +0000[diff] [blame]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
Guido van Rossumc2e20742006-02-27 22:32:47 +0000[diff] [blame]44# Blank lines correspond to available opcodes
Skip Montanaro3249ccd2003-02-27 21:27:52 +0000[diff] [blame]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
Raymond Hettinger9c18e812004-06-21 16:31:15 +0000[diff] [blame]53def_op('NOP', 9)
Skip Montanaro3249ccd2003-02-27 21:27:52 +0000[diff] [blame]54def_op('UNARY_POSITIVE', 10)
55def_op('UNARY_NEGATIVE', 11)
56def_op('UNARY_NOT', 12)
Skip Montanaro3249ccd2003-02-27 21:27:52 +0000[diff] [blame]57
58def_op('UNARY_INVERT', 15)
59
Nick Coghlan650f0d02007-04-15 12:05:43 +0000[diff] [blame]60def_op('SET_ADD', 17)
Raymond Hettingerdd80f762004-03-07 07:31:06 +0000[diff] [blame]61def_op('LIST_APPEND', 18)
Skip Montanaro3249ccd2003-02-27 21:27:52 +0000[diff] [blame]62def_op('BINARY_POWER', 19)
Skip Montanaro3249ccd2003-02-27 21:27:52 +0000[diff] [blame]63def_op('BINARY_MULTIPLY', 20)
Neal Norwitzc6d210c2006-03-16 06:02:10 +0000[diff] [blame]64
Skip Montanaro3249ccd2003-02-27 21:27:52 +0000[diff] [blame]65def_op('BINARY_MODULO', 22)
66def_op('BINARY_ADD', 23)
67def_op('BINARY_SUBTRACT', 24)
68def_op('BINARY_SUBSCR', 25)
69def_op('BINARY_FLOOR_DIVIDE', 26)
70def_op('BINARY_TRUE_DIVIDE', 27)
71def_op('INPLACE_FLOOR_DIVIDE', 28)
72def_op('INPLACE_TRUE_DIVIDE', 29)
Skip Montanaro3249ccd2003-02-27 21:27:52 +0000[diff] [blame]73
74def_op('INPLACE_ADD', 55)
75def_op('INPLACE_SUBTRACT', 56)
76def_op('INPLACE_MULTIPLY', 57)
Neal Norwitze7086d42006-03-17 08:59:09 +0000[diff] [blame]77
Skip Montanaro3249ccd2003-02-27 21:27:52 +0000[diff] [blame]78def_op('INPLACE_MODULO', 59)
79def_op('STORE_SUBSCR', 60)
80def_op('DELETE_SUBSCR', 61)
Skip Montanaro3249ccd2003-02-27 21:27:52 +0000[diff] [blame]81def_op('BINARY_LSHIFT', 62)
82def_op('BINARY_RSHIFT', 63)
83def_op('BINARY_AND', 64)
84def_op('BINARY_XOR', 65)
85def_op('BINARY_OR', 66)
86def_op('INPLACE_POWER', 67)
87def_op('GET_ITER', 68)
Guido van Rossum52cc1d82007-03-18 15:41:51 +0000[diff] [blame]88def_op('STORE_LOCALS', 69)
Skip Montanaro3249ccd2003-02-27 21:27:52 +0000[diff] [blame]89
90def_op('PRINT_EXPR', 70)
Guido van Rossum52cc1d82007-03-18 15:41:51 +0000[diff] [blame]91def_op('LOAD_BUILD_CLASS', 71)
Georg Brandl88fc6642007-02-09 21:28:07 +0000[diff] [blame]92
Skip Montanaro3249ccd2003-02-27 21:27:52 +0000[diff] [blame]93def_op('INPLACE_LSHIFT', 75)
94def_op('INPLACE_RSHIFT', 76)
95def_op('INPLACE_AND', 77)
96def_op('INPLACE_XOR', 78)
97def_op('INPLACE_OR', 79)
98def_op('BREAK_LOOP', 80)
Guido van Rossumc2e20742006-02-27 22:32:47 +0000[diff] [blame]99def_op('WITH_CLEANUP', 81)
Guido van Rossum52cc1d82007-03-18 15:41:51 +0000[diff] [blame]100
Skip Montanaro3249ccd2003-02-27 21:27:52 +0000[diff] [blame]101def_op('RETURN_VALUE', 83)
102def_op('IMPORT_STAR', 84)
Thomas Wouters00e41de2007-02-23 19:56:57 +0000[diff] [blame]103def_op('MAKE_BYTES', 85)
Skip Montanaro3249ccd2003-02-27 21:27:52 +0000[diff] [blame]104def_op('YIELD_VALUE', 86)
Skip Montanaro3249ccd2003-02-27 21:27:52 +0000[diff] [blame]105def_op('POP_BLOCK', 87)
106def_op('END_FINALLY', 88)
Skip Montanaro3249ccd2003-02-27 21:27:52 +0000[diff] [blame]107
108HAVE_ARGUMENT = 90 # Opcodes from here have an argument:
109
110name_op('STORE_NAME', 90) # Index in name list
111name_op('DELETE_NAME', 91) # ""
112def_op('UNPACK_SEQUENCE', 92) # Number of tuple items
113jrel_op('FOR_ITER', 93)
114
115name_op('STORE_ATTR', 95) # Index in name list
116name_op('DELETE_ATTR', 96) # ""
117name_op('STORE_GLOBAL', 97) # ""
118name_op('DELETE_GLOBAL', 98) # ""
119def_op('DUP_TOPX', 99) # number of items to duplicate
120def_op('LOAD_CONST', 100) # Index in const list
121hasconst.append(100)
122name_op('LOAD_NAME', 101) # Index in name list
123def_op('BUILD_TUPLE', 102) # Number of tuple items
124def_op('BUILD_LIST', 103) # Number of list items
Guido van Rossum86e58e22006-08-28 15:27:34 +0000[diff] [blame]125def_op('BUILD_SET', 104) # Number of set items
126def_op('BUILD_MAP', 105) # Always zero for now
127name_op('LOAD_ATTR', 106) # Index in name list
128def_op('COMPARE_OP', 107) # Comparison operator
129hascompare.append(107)
130name_op('IMPORT_NAME', 108) # Index in name list
131name_op('IMPORT_FROM', 109) # Index in name list
Skip Montanaro3249ccd2003-02-27 21:27:52 +0000[diff] [blame]132
133jrel_op('JUMP_FORWARD', 110) # Number of bytes to skip
134jrel_op('JUMP_IF_FALSE', 111) # ""
135jrel_op('JUMP_IF_TRUE', 112) # ""
136jabs_op('JUMP_ABSOLUTE', 113) # Target byte offset from beginning of code
137
138name_op('LOAD_GLOBAL', 116) # Index in name list
139
140jabs_op('CONTINUE_LOOP', 119) # Target address
141jrel_op('SETUP_LOOP', 120) # Distance to target address
142jrel_op('SETUP_EXCEPT', 121) # ""
143jrel_op('SETUP_FINALLY', 122) # ""
144
145def_op('LOAD_FAST', 124) # Local variable number
146haslocal.append(124)
147def_op('STORE_FAST', 125) # Local variable number
148haslocal.append(125)
149def_op('DELETE_FAST', 126) # Local variable number
150haslocal.append(126)
151
152def_op('RAISE_VARARGS', 130) # Number of raise arguments (1, 2, or 3)
153def_op('CALL_FUNCTION', 131) # #args + (#kwargs << 8)
154def_op('MAKE_FUNCTION', 132) # Number of args with default values
155def_op('BUILD_SLICE', 133) # Number of items
Skip Montanaro3249ccd2003-02-27 21:27:52 +0000[diff] [blame]156def_op('MAKE_CLOSURE', 134)
157def_op('LOAD_CLOSURE', 135)
158hasfree.append(135)
159def_op('LOAD_DEREF', 136)
160hasfree.append(136)
161def_op('STORE_DEREF', 137)
162hasfree.append(137)
163
164def_op('CALL_FUNCTION_VAR', 140) # #args + (#kwargs << 8)
165def_op('CALL_FUNCTION_KW', 141) # #args + (#kwargs << 8)
166def_op('CALL_FUNCTION_VAR_KW', 142) # #args + (#kwargs << 8)
Skip Montanaro3249ccd2003-02-27 21:27:52 +0000[diff] [blame]167def_op('EXTENDED_ARG', 143)
168EXTENDED_ARG = 143
169
170del def_op, name_op, jrel_op, jabs_op