1917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul/* 2917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * Copyright (C) 2009 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.SourcePosition; 22917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul 23917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul/** 24917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * Pseudo-instruction which is used to explicitly end the mapping of a 25917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * register to a named local variable. That is, an instance of this 26917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * class in an instruction stream indicates that starting with the 27917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * subsequent instruction, the indicated variable is no longer valid. 28917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul */ 29917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgulpublic final class LocalEnd extends ZeroSizeInsn { 30917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul /** 31917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * {@code non-null;} register spec representing the local variable ended 32917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * by this instance. <b>Note:</b> Technically, only the register 33917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * number needs to be recorded here as the rest of the information 34917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * is implicit in the ambient local variable state, but other code 35917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * will check the other info for consistency. 36917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul */ 37917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul private final RegisterSpec local; 38917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul 39917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul /** 40917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * Constructs an instance. The output address of this instance is initially 41917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * unknown ({@code -1}). 42917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * 43917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * @param position {@code non-null;} source position 44917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * @param local {@code non-null;} register spec representing the local 45917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * variable introduced by this instance 46917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul */ 47917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul public LocalEnd(SourcePosition position, RegisterSpec local) { 48917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul super(position); 49917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul 50917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul if (local == null) { 51917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul throw new NullPointerException("local == null"); 52917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul } 53917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul 54917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul this.local = local; 55917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul } 56917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul 57917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul /** {@inheritDoc} */ 58917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul @Override 59917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul public DalvInsn withRegisterOffset(int delta) { 60917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul return new LocalEnd(getPosition(), local.withOffset(delta)); 61917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul } 62917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul 63917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul /** {@inheritDoc} */ 64917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul @Override 65917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul public DalvInsn withRegisters(RegisterSpecList registers) { 66917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul return new LocalEnd(getPosition(), local); 67917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul } 68917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul 69917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul /** 70917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * Gets the register spec representing the local variable ended 71917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * by this instance. 72917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * 73917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * @return {@code non-null;} the register spec 74917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul */ 75917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul public RegisterSpec getLocal() { 76917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul return local; 77917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul } 78917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul 79917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul /** {@inheritDoc} */ 80917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul @Override 81917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul protected String argString() { 82917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul return local.toString(); 83917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul } 84917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul 85917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul /** {@inheritDoc} */ 86917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul @Override 87917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul protected String listingString0(boolean noteIndices) { 88917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul return "local-end " + LocalStart.localString(local); 89917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul } 90917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul} 91