1917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul/* 2917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * Copyright (C) 2007 The Android Open Source Project 3917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * 4917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * Licensed under the Apache License, Version 2.0 (the "License"); 5917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * you may not use this file except in compliance with the License. 6917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * You may obtain a copy of the License at 7917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * 8917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * http://www.apache.org/licenses/LICENSE-2.0 9917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * 10917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * Unless required by applicable law or agreed to in writing, software 11917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * distributed under the License is distributed on an "AS IS" BASIS, 12917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * See the License for the specific language governing permissions and 14917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * limitations under the License. 15917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul */ 16917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul 17917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgulpackage com.android.dexgen.dex.code; 18917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul 19917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgulimport com.android.dexgen.rop.code.RegisterSpec; 20917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgulimport com.android.dexgen.rop.code.RegisterSpecList; 21917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgulimport com.android.dexgen.rop.code.RegisterSpecSet; 22917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgulimport com.android.dexgen.rop.code.SourcePosition; 23917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul 24917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul/** 25917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * Pseudo-instruction which is used to hold a snapshot of the 26917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * state of local variable name mappings that exists immediately after 27917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * the instance in an instruction array. 28917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul */ 29917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgulpublic final class LocalSnapshot extends ZeroSizeInsn { 30917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul /** {@code non-null;} local state associated with this instance */ 31917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul private final RegisterSpecSet locals; 32917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul 33917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul /** 34917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * Constructs an instance. The output address of this instance is initially 35917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * unknown ({@code -1}). 36917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * 37917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * @param position {@code non-null;} source position 38917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * @param locals {@code non-null;} associated local variable state 39917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul */ 40917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul public LocalSnapshot(SourcePosition position, RegisterSpecSet locals) { 41917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul super(position); 42917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul 43917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul if (locals == null) { 44917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul throw new NullPointerException("locals == null"); 45917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul } 46917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul 47917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul this.locals = locals; 48917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul } 49917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul 50917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul /** {@inheritDoc} */ 51917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul @Override 52917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul public DalvInsn withRegisterOffset(int delta) { 53917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul return new LocalSnapshot(getPosition(), locals.withOffset(delta)); 54917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul } 55917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul 56917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul /** {@inheritDoc} */ 57917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul @Override 58917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul public DalvInsn withRegisters(RegisterSpecList registers) { 59917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul return new LocalSnapshot(getPosition(), locals); 60917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul } 61917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul 62917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul /** 63917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * Gets the local state associated with this instance. 64917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * 65917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * @return {@code non-null;} the state 66917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul */ 67917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul public RegisterSpecSet getLocals() { 68917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul return locals; 69917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul } 70917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul 71917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul /** {@inheritDoc} */ 72917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul @Override 73917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul protected String argString() { 74917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul return locals.toString(); 75917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul } 76917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul 77917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul /** {@inheritDoc} */ 78917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul @Override 79917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul protected String listingString0(boolean noteIndices) { 80917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul int sz = locals.size(); 81917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul int max = locals.getMaxSize(); 82917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul StringBuffer sb = new StringBuffer(100 + sz * 40); 83917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul 84917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul sb.append("local-snapshot"); 85917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul 86917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul for (int i = 0; i < max; i++) { 87917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul RegisterSpec spec = locals.get(i); 88917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul if (spec != null) { 89917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul sb.append("\n "); 90917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul sb.append(LocalStart.localString(spec)); 91917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul } 92917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul } 93917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul 94917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul return sb.toString(); 95917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul } 96917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul} 97