1f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/* 2f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Copyright (C) 2009 The Android Open Source Project 3f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 4f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 5f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * you may not use this file except in compliance with the License. 6f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * You may obtain a copy of the License at 7f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 8f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 9f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 10f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 11f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 12f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * See the License for the specific language governing permissions and 14f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * limitations under the License. 15f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 16f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 17f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectpackage com.android.dx.dex.code; 18f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 19f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectimport com.android.dx.rop.code.RegisterSpec; 20f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectimport com.android.dx.rop.code.RegisterSpecList; 21f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectimport com.android.dx.rop.code.SourcePosition; 22f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 23f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/** 24f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Pseudo-instruction which is used to explicitly end the mapping of a 25f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * register to a named local variable. That is, an instance of this 26f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * class in an instruction stream indicates that starting with the 27f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * subsequent instruction, the indicated variable is no longer valid. 28f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 29f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectpublic final class LocalEnd extends ZeroSizeInsn { 30f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 3199409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project * {@code non-null;} register spec representing the local variable ended 32f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * by this instance. <b>Note:</b> Technically, only the register 33f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * number needs to be recorded here as the rest of the information 34f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * is implicit in the ambient local variable state, but other code 35f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * will check the other info for consistency. 36f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 37f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project private final RegisterSpec local; 38f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 39f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 40f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Constructs an instance. The output address of this instance is initially 4199409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project * unknown ({@code -1}). 42de75089fb7216d19e9c22cce4dc62a49513477d3Carl Shapiro * 4399409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project * @param position {@code non-null;} source position 4499409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project * @param local {@code non-null;} register spec representing the local 45f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * variable introduced by this instance 46f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 47f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public LocalEnd(SourcePosition position, RegisterSpec local) { 48f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project super(position); 49f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 50f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project if (local == null) { 51f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project throw new NullPointerException("local == null"); 52f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 53f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 54f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project this.local = local; 55f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 56f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 57f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** {@inheritDoc} */ 58f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project @Override 59f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public DalvInsn withRegisterOffset(int delta) { 60f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project return new LocalEnd(getPosition(), local.withOffset(delta)); 61f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 62f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 63f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** {@inheritDoc} */ 64f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project @Override 65f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public DalvInsn withRegisters(RegisterSpecList registers) { 66f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project return new LocalEnd(getPosition(), local); 67f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 68f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 69f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 70f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Gets the register spec representing the local variable ended 71f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * by this instance. 72de75089fb7216d19e9c22cce4dc62a49513477d3Carl Shapiro * 7399409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project * @return {@code non-null;} the register spec 74f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 75f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public RegisterSpec getLocal() { 76f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project return local; 77f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 78f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 79f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** {@inheritDoc} */ 80f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project @Override 81f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project protected String argString() { 82f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project return local.toString(); 83f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 84f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 85f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** {@inheritDoc} */ 86f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project @Override 87f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project protected String listingString0(boolean noteIndices) { 88f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project return "local-end " + LocalStart.localString(local); 89f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 90f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project} 91