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 15-Jun-1998 by Raja Vallee-Rai (kor@sable.mcgill.ca). (*) 00106 First internal release (Version 0.1). 00107 */ 00108 00109 import java.io.*; 00110 00111 /** A debugging attribute, this gives the names of local variables 00112 * within blocks of bytecode. 00113 * @see attribute_info 00114 * @author Clark Verbrugge 00115 */ 00116 class LocalVariableTable_attribute extends attribute_info { 00117 /** Length of the local variable table. */ 00118 public int local_variable_table_length; 00119 /** Actual table of local variables. */ 00120 public local_variable_table_entry local_variable_table[]; 00121 00122 /** Locates the first name found for a given local variable. 00123 * @param constant_pool constant pool for the associated class. 00124 * @param idx local variable index. 00125 * @return name of the local variable, or <i>null</i> if not found. 00126 * @see LocalVariableTable_attribute#getLocalVariableName(cp_info[], int, int) 00127 */ 00128 public String getLocalVariableName(cp_info constant_pool[],int idx) { 00129 return getLocalVariableName(constant_pool,idx,-1); 00130 } 00131 /** Locates the name of the given local variable for the specified code offset. 00132 * @param constant_pool constant pool for the associated class. 00133 * @param idx local variable index. 00134 * @param code code offset for variable name; use -1 to return the first name found 00135 * for that local variable. 00136 * @return name of the local variable, or <i>null</i> if not found. 00137 * @see LocalVariableTable_attribute#getLocalVariableName(cp_info[], int) 00138 */ 00139 public String getLocalVariableName(cp_info constant_pool[],int idx,int code) { 00140 local_variable_table_entry e; 00141 CONSTANT_Utf8_info cu; 00142 int i; 00143 00144 // now to find that variable 00145 for (i=0;i<local_variable_table_length;i++) { 00146 e = local_variable_table[i]; 00147 if (e.index==idx && 00148 (code==-1 || 00149 (code>=e.start_pc && code<e.start_pc+e.length))) { 00150 // found the variable, now find its name. 00151 if (constant_pool[e.name_index] instanceof CONSTANT_Utf8_info) 00152 return ((CONSTANT_Utf8_info)(constant_pool[e.name_index])).convert(); 00153 else { 00154 System.out.println("What? A local variable table name_index isn't" + 00155 " a UTF8 entry?"); 00156 System.exit(1); 00157 } 00158 } 00159 } 00160 return null; 00161 } 00162 }
1.2.10 written by Dimitri van Heesch,
© 1997-2001