1 /*
2  * reserved comment block
3  * DO NOT REMOVE OR ALTER!
4  */
5 /*
6  * Licensed to the Apache Software Foundation (ASF) under one or more
7  * contributor license agreements.  See the NOTICE file distributed with
8  * this work for additional information regarding copyright ownership.
9  * The ASF licenses this file to You under the Apache License, Version 2.0
10  * (the "License"); you may not use this file except in compliance with
11  * the License.  You may obtain a copy of the License at
12  *
13  *      http://www.apache.org/licenses/LICENSE-2.0
14  *
15  * Unless required by applicable law or agreed to in writing, software
16  * distributed under the License is distributed on an "AS IS" BASIS,
17  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
18  * See the License for the specific language governing permissions and
19  * limitations under the License.
20  */
21 
22 package com.sun.org.apache.bcel.internal.generic;
23 
24 import com.sun.org.apache.bcel.internal.Const;
25 
26 /**
27  * This interface contains shareable instruction objects.
28  *
29  * In order to save memory you can use some instructions multiply,
30  * since they have an immutable state and are directly derived from
31  * Instruction.  I.e. they have no instance fields that could be
32  * changed. Since some of these instructions like ICONST_0 occur
33  * very frequently this can save a lot of time and space. This
34  * feature is an adaptation of the FlyWeight design pattern, we
35  * just use an array instead of a factory.
36  *
37  * The Instructions can also accessed directly under their names, so
38  * it's possible to write il.append(Instruction.ICONST_0);
39  *
40  */
41 public final class InstructionConst {
42 
43     /**
44      * Predefined instruction objects
45      */
46     /*
47      * NOTE these are not currently immutable, because Instruction
48      * has mutable protected fields opcode and length.
49      */
50     public static final Instruction NOP = new NOP();
51     public static final Instruction ACONST_NULL = new ACONST_NULL();
52     public static final Instruction ICONST_M1 = new ICONST(-1);
53     public static final Instruction ICONST_0 = new ICONST(0);
54     public static final Instruction ICONST_1 = new ICONST(1);
55     public static final Instruction ICONST_2 = new ICONST(2);
56     public static final Instruction ICONST_3 = new ICONST(3);
57     public static final Instruction ICONST_4 = new ICONST(4);
58     public static final Instruction ICONST_5 = new ICONST(5);
59     public static final Instruction LCONST_0 = new LCONST(0);
60     public static final Instruction LCONST_1 = new LCONST(1);
61     public static final Instruction FCONST_0 = new FCONST(0);
62     public static final Instruction FCONST_1 = new FCONST(1);
63     public static final Instruction FCONST_2 = new FCONST(2);
64     public static final Instruction DCONST_0 = new DCONST(0);
65     public static final Instruction DCONST_1 = new DCONST(1);
66     public static final ArrayInstruction IALOAD = new IALOAD();
67     public static final ArrayInstruction LALOAD = new LALOAD();
68     public static final ArrayInstruction FALOAD = new FALOAD();
69     public static final ArrayInstruction DALOAD = new DALOAD();
70     public static final ArrayInstruction AALOAD = new AALOAD();
71     public static final ArrayInstruction BALOAD = new BALOAD();
72     public static final ArrayInstruction CALOAD = new CALOAD();
73     public static final ArrayInstruction SALOAD = new SALOAD();
74     public static final ArrayInstruction IASTORE = new IASTORE();
75     public static final ArrayInstruction LASTORE = new LASTORE();
76     public static final ArrayInstruction FASTORE = new FASTORE();
77     public static final ArrayInstruction DASTORE = new DASTORE();
78     public static final ArrayInstruction AASTORE = new AASTORE();
79     public static final ArrayInstruction BASTORE = new BASTORE();
80     public static final ArrayInstruction CASTORE = new CASTORE();
81     public static final ArrayInstruction SASTORE = new SASTORE();
82     public static final StackInstruction POP = new POP();
83     public static final StackInstruction POP2 = new POP2();
84     public static final StackInstruction DUP = new DUP();
85     public static final StackInstruction DUP_X1 = new DUP_X1();
86     public static final StackInstruction DUP_X2 = new DUP_X2();
87     public static final StackInstruction DUP2 = new DUP2();
88     public static final StackInstruction DUP2_X1 = new DUP2_X1();
89     public static final StackInstruction DUP2_X2 = new DUP2_X2();
90     public static final StackInstruction SWAP = new SWAP();
91     public static final ArithmeticInstruction IADD = new IADD();
92     public static final ArithmeticInstruction LADD = new LADD();
93     public static final ArithmeticInstruction FADD = new FADD();
94     public static final ArithmeticInstruction DADD = new DADD();
95     public static final ArithmeticInstruction ISUB = new ISUB();
96     public static final ArithmeticInstruction LSUB = new LSUB();
97     public static final ArithmeticInstruction FSUB = new FSUB();
98     public static final ArithmeticInstruction DSUB = new DSUB();
99     public static final ArithmeticInstruction IMUL = new IMUL();
100     public static final ArithmeticInstruction LMUL = new LMUL();
101     public static final ArithmeticInstruction FMUL = new FMUL();
102     public static final ArithmeticInstruction DMUL = new DMUL();
103     public static final ArithmeticInstruction IDIV = new IDIV();
104     public static final ArithmeticInstruction LDIV = new LDIV();
105     public static final ArithmeticInstruction FDIV = new FDIV();
106     public static final ArithmeticInstruction DDIV = new DDIV();
107     public static final ArithmeticInstruction IREM = new IREM();
108     public static final ArithmeticInstruction LREM = new LREM();
109     public static final ArithmeticInstruction FREM = new FREM();
110     public static final ArithmeticInstruction DREM = new DREM();
111     public static final ArithmeticInstruction INEG = new INEG();
112     public static final ArithmeticInstruction LNEG = new LNEG();
113     public static final ArithmeticInstruction FNEG = new FNEG();
114     public static final ArithmeticInstruction DNEG = new DNEG();
115     public static final ArithmeticInstruction ISHL = new ISHL();
116     public static final ArithmeticInstruction LSHL = new LSHL();
117     public static final ArithmeticInstruction ISHR = new ISHR();
118     public static final ArithmeticInstruction LSHR = new LSHR();
119     public static final ArithmeticInstruction IUSHR = new IUSHR();
120     public static final ArithmeticInstruction LUSHR = new LUSHR();
121     public static final ArithmeticInstruction IAND = new IAND();
122     public static final ArithmeticInstruction LAND = new LAND();
123     public static final ArithmeticInstruction IOR = new IOR();
124     public static final ArithmeticInstruction LOR = new LOR();
125     public static final ArithmeticInstruction IXOR = new IXOR();
126     public static final ArithmeticInstruction LXOR = new LXOR();
127     public static final ConversionInstruction I2L = new I2L();
128     public static final ConversionInstruction I2F = new I2F();
129     public static final ConversionInstruction I2D = new I2D();
130     public static final ConversionInstruction L2I = new L2I();
131     public static final ConversionInstruction L2F = new L2F();
132     public static final ConversionInstruction L2D = new L2D();
133     public static final ConversionInstruction F2I = new F2I();
134     public static final ConversionInstruction F2L = new F2L();
135     public static final ConversionInstruction F2D = new F2D();
136     public static final ConversionInstruction D2I = new D2I();
137     public static final ConversionInstruction D2L = new D2L();
138     public static final ConversionInstruction D2F = new D2F();
139     public static final ConversionInstruction I2B = new I2B();
140     public static final ConversionInstruction I2C = new I2C();
141     public static final ConversionInstruction I2S = new I2S();
142     public static final Instruction LCMP = new LCMP();
143     public static final Instruction FCMPL = new FCMPL();
144     public static final Instruction FCMPG = new FCMPG();
145     public static final Instruction DCMPL = new DCMPL();
146     public static final Instruction DCMPG = new DCMPG();
147     public static final ReturnInstruction IRETURN = new IRETURN();
148     public static final ReturnInstruction LRETURN = new LRETURN();
149     public static final ReturnInstruction FRETURN = new FRETURN();
150     public static final ReturnInstruction DRETURN = new DRETURN();
151     public static final ReturnInstruction ARETURN = new ARETURN();
152     public static final ReturnInstruction RETURN = new RETURN();
153     public static final Instruction ARRAYLENGTH = new ARRAYLENGTH();
154     public static final Instruction ATHROW = new ATHROW();
155     public static final Instruction MONITORENTER = new MONITORENTER();
156     public static final Instruction MONITOREXIT = new MONITOREXIT();
157 
158     /** You can use these constants in multiple places safely, if you can guarantee
159      * that you will never alter their internal values, e.g. call setIndex().
160      */
161     public static final LocalVariableInstruction THIS = new ALOAD(0);
162     public static final LocalVariableInstruction ALOAD_0 = THIS;
163     public static final LocalVariableInstruction ALOAD_1 = new ALOAD(1);
164     public static final LocalVariableInstruction ALOAD_2 = new ALOAD(2);
165     public static final LocalVariableInstruction ILOAD_0 = new ILOAD(0);
166     public static final LocalVariableInstruction ILOAD_1 = new ILOAD(1);
167     public static final LocalVariableInstruction ILOAD_2 = new ILOAD(2);
168     public static final LocalVariableInstruction ASTORE_0 = new ASTORE(0);
169     public static final LocalVariableInstruction ASTORE_1 = new ASTORE(1);
170     public static final LocalVariableInstruction ASTORE_2 = new ASTORE(2);
171     public static final LocalVariableInstruction ISTORE_0 = new ISTORE(0);
172     public static final LocalVariableInstruction ISTORE_1 = new ISTORE(1);
173     public static final LocalVariableInstruction ISTORE_2 = new ISTORE(2);
174 
175     /** Get object via its opcode, for immutable instructions like
176      * branch instructions entries are set to null.
177      */
178     private static final Instruction[] INSTRUCTIONS = new Instruction[256];
179 
180     static {
181         INSTRUCTIONS[Const.NOP] = NOP;
182         INSTRUCTIONS[Const.ACONST_NULL] = ACONST_NULL;
183         INSTRUCTIONS[Const.ICONST_M1] = ICONST_M1;
184         INSTRUCTIONS[Const.ICONST_0] = ICONST_0;
185         INSTRUCTIONS[Const.ICONST_1] = ICONST_1;
186         INSTRUCTIONS[Const.ICONST_2] = ICONST_2;
187         INSTRUCTIONS[Const.ICONST_3] = ICONST_3;
188         INSTRUCTIONS[Const.ICONST_4] = ICONST_4;
189         INSTRUCTIONS[Const.ICONST_5] = ICONST_5;
190         INSTRUCTIONS[Const.LCONST_0] = LCONST_0;
191         INSTRUCTIONS[Const.LCONST_1] = LCONST_1;
192         INSTRUCTIONS[Const.FCONST_0] = FCONST_0;
193         INSTRUCTIONS[Const.FCONST_1] = FCONST_1;
194         INSTRUCTIONS[Const.FCONST_2] = FCONST_2;
195         INSTRUCTIONS[Const.DCONST_0] = DCONST_0;
196         INSTRUCTIONS[Const.DCONST_1] = DCONST_1;
197         INSTRUCTIONS[Const.IALOAD] = IALOAD;
198         INSTRUCTIONS[Const.LALOAD] = LALOAD;
199         INSTRUCTIONS[Const.FALOAD] = FALOAD;
200         INSTRUCTIONS[Const.DALOAD] = DALOAD;
201         INSTRUCTIONS[Const.AALOAD] = AALOAD;
202         INSTRUCTIONS[Const.BALOAD] = BALOAD;
203         INSTRUCTIONS[Const.CALOAD] = CALOAD;
204         INSTRUCTIONS[Const.SALOAD] = SALOAD;
205         INSTRUCTIONS[Const.IASTORE] = IASTORE;
206         INSTRUCTIONS[Const.LASTORE] = LASTORE;
207         INSTRUCTIONS[Const.FASTORE] = FASTORE;
208         INSTRUCTIONS[Const.DASTORE] = DASTORE;
209         INSTRUCTIONS[Const.AASTORE] = AASTORE;
210         INSTRUCTIONS[Const.BASTORE] = BASTORE;
211         INSTRUCTIONS[Const.CASTORE] = CASTORE;
212         INSTRUCTIONS[Const.SASTORE] = SASTORE;
213         INSTRUCTIONS[Const.POP] = POP;
214         INSTRUCTIONS[Const.POP2] = POP2;
215         INSTRUCTIONS[Const.DUP] = DUP;
216         INSTRUCTIONS[Const.DUP_X1] = DUP_X1;
217         INSTRUCTIONS[Const.DUP_X2] = DUP_X2;
218         INSTRUCTIONS[Const.DUP2] = DUP2;
219         INSTRUCTIONS[Const.DUP2_X1] = DUP2_X1;
220         INSTRUCTIONS[Const.DUP2_X2] = DUP2_X2;
221         INSTRUCTIONS[Const.SWAP] = SWAP;
222         INSTRUCTIONS[Const.IADD] = IADD;
223         INSTRUCTIONS[Const.LADD] = LADD;
224         INSTRUCTIONS[Const.FADD] = FADD;
225         INSTRUCTIONS[Const.DADD] = DADD;
226         INSTRUCTIONS[Const.ISUB] = ISUB;
227         INSTRUCTIONS[Const.LSUB] = LSUB;
228         INSTRUCTIONS[Const.FSUB] = FSUB;
229         INSTRUCTIONS[Const.DSUB] = DSUB;
230         INSTRUCTIONS[Const.IMUL] = IMUL;
231         INSTRUCTIONS[Const.LMUL] = LMUL;
232         INSTRUCTIONS[Const.FMUL] = FMUL;
233         INSTRUCTIONS[Const.DMUL] = DMUL;
234         INSTRUCTIONS[Const.IDIV] = IDIV;
235         INSTRUCTIONS[Const.LDIV] = LDIV;
236         INSTRUCTIONS[Const.FDIV] = FDIV;
237         INSTRUCTIONS[Const.DDIV] = DDIV;
238         INSTRUCTIONS[Const.IREM] = IREM;
239         INSTRUCTIONS[Const.LREM] = LREM;
240         INSTRUCTIONS[Const.FREM] = FREM;
241         INSTRUCTIONS[Const.DREM] = DREM;
242         INSTRUCTIONS[Const.INEG] = INEG;
243         INSTRUCTIONS[Const.LNEG] = LNEG;
244         INSTRUCTIONS[Const.FNEG] = FNEG;
245         INSTRUCTIONS[Const.DNEG] = DNEG;
246         INSTRUCTIONS[Const.ISHL] = ISHL;
247         INSTRUCTIONS[Const.LSHL] = LSHL;
248         INSTRUCTIONS[Const.ISHR] = ISHR;
249         INSTRUCTIONS[Const.LSHR] = LSHR;
250         INSTRUCTIONS[Const.IUSHR] = IUSHR;
251         INSTRUCTIONS[Const.LUSHR] = LUSHR;
252         INSTRUCTIONS[Const.IAND] = IAND;
253         INSTRUCTIONS[Const.LAND] = LAND;
254         INSTRUCTIONS[Const.IOR] = IOR;
255         INSTRUCTIONS[Const.LOR] = LOR;
256         INSTRUCTIONS[Const.IXOR] = IXOR;
257         INSTRUCTIONS[Const.LXOR] = LXOR;
258         INSTRUCTIONS[Const.I2L] = I2L;
259         INSTRUCTIONS[Const.I2F] = I2F;
260         INSTRUCTIONS[Const.I2D] = I2D;
261         INSTRUCTIONS[Const.L2I] = L2I;
262         INSTRUCTIONS[Const.L2F] = L2F;
263         INSTRUCTIONS[Const.L2D] = L2D;
264         INSTRUCTIONS[Const.F2I] = F2I;
265         INSTRUCTIONS[Const.F2L] = F2L;
266         INSTRUCTIONS[Const.F2D] = F2D;
267         INSTRUCTIONS[Const.D2I] = D2I;
268         INSTRUCTIONS[Const.D2L] = D2L;
269         INSTRUCTIONS[Const.D2F] = D2F;
270         INSTRUCTIONS[Const.I2B] = I2B;
271         INSTRUCTIONS[Const.I2C] = I2C;
272         INSTRUCTIONS[Const.I2S] = I2S;
273         INSTRUCTIONS[Const.LCMP] = LCMP;
274         INSTRUCTIONS[Const.FCMPL] = FCMPL;
275         INSTRUCTIONS[Const.FCMPG] = FCMPG;
276         INSTRUCTIONS[Const.DCMPL] = DCMPL;
277         INSTRUCTIONS[Const.DCMPG] = DCMPG;
278         INSTRUCTIONS[Const.IRETURN] = IRETURN;
279         INSTRUCTIONS[Const.LRETURN] = LRETURN;
280         INSTRUCTIONS[Const.FRETURN] = FRETURN;
281         INSTRUCTIONS[Const.DRETURN] = DRETURN;
282         INSTRUCTIONS[Const.ARETURN] = ARETURN;
283         INSTRUCTIONS[Const.RETURN] = RETURN;
284         INSTRUCTIONS[Const.ARRAYLENGTH] = ARRAYLENGTH;
285         INSTRUCTIONS[Const.ATHROW] = ATHROW;
286         INSTRUCTIONS[Const.MONITORENTER] = MONITORENTER;
287         INSTRUCTIONS[Const.MONITOREXIT] = MONITOREXIT;
288     }
289 
InstructionConst()290     private InstructionConst() { } // non-instantiable
291 
292     /**
293      * Gets the Instruction.
294      * @param index the index, e.g. {@link Const#RETURN}
295      * @return the entry from the private INSTRUCTIONS table
296      */
getInstruction(final int index)297     public static Instruction getInstruction(final int index) {
298         return INSTRUCTIONS[index];
299     }
300 }
301