00001 package ca.mcgill.sable.soot.coffi; 00002 00003 /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 00004 * Jimple, a 3-address code Java(TM) bytecode representation. * 00005 * Copyright (C) 1997, 1998 Raja Vallee-Rai (kor@sable.mcgill.ca) * 00006 * All rights reserved. * 00007 * * 00008 * This work was done as a project of the Sable Research Group, * 00009 * School of Computer Science, McGill University, Canada * 00010 * (http://www.sable.mcgill.ca/). It is understood that any * 00011 * modification not identified as such is not covered by the * 00012 * preceding statement. * 00013 * * 00014 * This work is free software; you can redistribute it and/or * 00015 * modify it under the terms of the GNU Library General Public * 00016 * License as published by the Free Software Foundation; either * 00017 * version 2 of the License, or (at your option) any later version. * 00018 * * 00019 * This work is distributed in the hope that it will be useful, * 00020 * but WITHOUT ANY WARRANTY; without even the implied warranty of * 00021 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * 00022 * Library General Public License for more details. * 00023 * * 00024 * You should have received a copy of the GNU Library General Public * 00025 * License along with this library; if not, write to the * 00026 * Free Software Foundation, Inc., 59 Temple Place - Suite 330, * 00027 * Boston, MA 02111-1307, USA. * 00028 * * 00029 * Java is a trademark of Sun Microsystems, Inc. * 00030 * * 00031 * To submit a bug report, send a comment, or get the latest news on * 00032 * this project and other Sable Research Group projects, please * 00033 * visit the web site: http://www.sable.mcgill.ca/ * 00034 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */ 00035 00036 /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 00037 * Coffi, a bytecode parser for the Java(TM) language. * 00038 * Copyright (C) 1996, 1997 Clark Verbrugge (clump@sable.mcgill.ca). * 00039 * All rights reserved. * 00040 * * 00041 * This work was done as a project of the Sable Research Group, * 00042 * School of Computer Science, McGill University, Canada * 00043 * (http://www.sable.mcgill.ca/). It is understood that any * 00044 * modification not identified as such is not covered by the * 00045 * preceding statement. * 00046 * * 00047 * This work is free software; you can redistribute it and/or * 00048 * modify it under the terms of the GNU Library General Public * 00049 * License as published by the Free Software Foundation; either * 00050 * version 2 of the License, or (at your option) any later version. * 00051 * * 00052 * This work is distributed in the hope that it will be useful, * 00053 * but WITHOUT ANY WARRANTY; without even the implied warranty of * 00054 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * 00055 * Library General Public License for more details. * 00056 * * 00057 * You should have received a copy of the GNU Library General Public * 00058 * License along with this library; if not, write to the * 00059 * Free Software Foundation, Inc., 59 Temple Place - Suite 330, * 00060 * Boston, MA 02111-1307, USA. * 00061 * * 00062 * Java is a trademark of Sun Microsystems, Inc. * 00063 * * 00064 * To submit a bug report, send a comment, or get the latest news on * 00065 * this project and other Sable Research Group projects, please * 00066 * visit the web site: http://www.sable.mcgill.ca/ * 00067 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */ 00068 00069 /* 00070 Reference Version 00071 ----------------- 00072 This is the latest official version on which this file is based. 00073 The reference version is: $CoffiVersion: 1.1 $ 00074 $SootVersion: 1.beta.4 $ 00075 00076 Change History 00077 -------------- 00078 A) Notes: 00079 00080 Please use the following template. Most recent changes should 00081 appear at the top of the list. 00082 00083 - Modified on [date (March 1, 1900)] by [name]. [(*) if appropriate] 00084 [description of modification]. 00085 00086 Any Modification flagged with "(*)" was done as a project of the 00087 Sable Research Group, School of Computer Science, 00088 McGill University, Canada (http://www.sable.mcgill.ca/). 00089 00090 You should add your copyright, using the following template, at 00091 the top of this file, along with other copyrights. 00092 00093 * * 00094 * Modifications by [name] are * 00095 * Copyright (C) [year(s)] [your name (or company)]. All rights * 00096 * reserved. * 00097 * * 00098 00099 B) Changes: 00100 00101 - Modified on November 2, 1998 by Raja Vallee-Rai (kor@sable.mcgill.ca) (*) 00102 Repackaged all source files and performed extensive modifications. 00103 First initial release of Soot. 00104 00105 - Modified on 28-Aug-1998 by Raja Vallee-Rai (kor@sable.mcgill.ca). (*) 00106 Fixed the wide instructions. 00107 00108 - Modified on 15-Jun-1998 by Raja Vallee-Rai (kor@sable.mcgill.ca). (*) 00109 First internal release (Version 0.1). 00110 */ 00111 00112 import java.io.*; 00113 /** Instruction subclasses are used to represent parsed bytecode; each 00114 * bytecode operation has a corresponding subclass of Instruction. 00115 * <p> 00116 * Each subclass is derived from one of 00117 * <ul><li>Instruction</li> 00118 * <li>Instruction_noargs (an Instruction with no embedded arguments)</li> 00119 * <li>Instruction_byte (an Instruction with a single byte data argument)</li> 00120 * <li>Instruction_bytevar (a byte argument specifying a local variable)</li> 00121 * <li>Instruction_byteindex (a byte argument specifying a constant pool index)</li> 00122 * <li>Instruction_int (an Instruction with a single short data argument)</li> 00123 * <li>Instruction_intvar (a short argument specifying a local variable)</li> 00124 * <li>Instruction_intindex (a short argument specifying a constant pool index)</li> 00125 * <li>Instruction_intbranch (a short argument specifying a code offset)</li> 00126 * <li>Instruction_longbranch (an int argument specifying a code offset)</li> 00127 * </ul> 00128 * @author Clark Verbrugge 00129 * @see Instruction 00130 * @see Instruction_noargs 00131 * @see Instruction_byte 00132 * @see Instruction_bytevar 00133 * @see Instruction_byteindex 00134 * @see Instruction_int 00135 * @see Instruction_intvar 00136 * @see Instruction_intindex 00137 * @see Instruction_intbranch 00138 * @see Instruction_longbranch 00139 * @see Instruction_Unknown 00140 */ 00141 class Instruction_bytevar extends Instruction { 00142 /** 00143 * arg_b needs to be short in order to contain all the possible values for an unsigned byte 00144 */ 00145 public int arg_b; 00146 public boolean isWide; 00147 00148 public Instruction_bytevar(byte c) { super(c); } 00149 public int compile(byte bc[],int index) { bc[index++] = code; bc[index++] = (byte) arg_b; return index; } 00150 public int nextOffset(int curr) { return curr + 1 + ((isWide) ? 3 : 1); } 00151 public int parse(byte bc[],int index) 00152 { 00153 int indexbyte1 = ((int) bc[index]) & 0xff; 00154 00155 if(isWide) 00156 { 00157 int indexbyte2 = ((int) bc[index+1]) & 0xff; 00158 00159 arg_b = (indexbyte1 << 8) | indexbyte2; 00160 00161 return index+2; 00162 } 00163 else 00164 { 00165 arg_b = indexbyte1; 00166 return index+1; 00167 } 00168 } 00169 public String toString(cp_info constant_pool[]) { 00170 return super.toString(constant_pool) + argsep + LOCALPREFIX + arg_b; 00171 } 00172 }