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.SourcePosition; 22917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul 23917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul/** 24917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * Pseudo-instruction which is used to introduce a new local variable. That 25917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * is, an instance of this class in an instruction stream indicates that 26917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * starting with the subsequent instruction, the indicated variable 27917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * is bound. 28917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul */ 29917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgulpublic final class LocalStart extends ZeroSizeInsn { 30917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul /** 31917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * {@code non-null;} register spec representing the local variable introduced 32917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * by this instance 33917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul */ 34917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul private final RegisterSpec local; 35917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul 36917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul /** 37917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * Returns the local variable listing string for a single register spec. 38917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * 39917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * @param spec {@code non-null;} the spec to convert 40917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * @return {@code non-null;} the string form 41917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul */ 42917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul public static String localString(RegisterSpec spec) { 43917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul return spec.regString() + ' ' + spec.getLocalItem().toString() + ": " + 44917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul spec.getTypeBearer().toHuman(); 45917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul } 46917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul 47917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul /** 48917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * Constructs an instance. The output address of this instance is initially 49917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * unknown ({@code -1}). 50917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * 51917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * @param position {@code non-null;} source position 52917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * @param local {@code non-null;} register spec representing the local 53917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * variable introduced by this instance 54917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul */ 55917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul public LocalStart(SourcePosition position, RegisterSpec local) { 56917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul super(position); 57917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul 58917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul if (local == null) { 59917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul throw new NullPointerException("local == null"); 60917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul } 61917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul 62917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul this.local = local; 63917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul } 64917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul 65917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul /** {@inheritDoc} */ 66917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul @Override 67917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul public DalvInsn withRegisterOffset(int delta) { 68917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul return new LocalStart(getPosition(), local.withOffset(delta)); 69917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul } 70917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul 71917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul /** {@inheritDoc} */ 72917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul @Override 73917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul public DalvInsn withRegisters(RegisterSpecList registers) { 74917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul return new LocalStart(getPosition(), local); 75917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul } 76917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul 77917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul /** 78917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * Gets the register spec representing the local variable introduced 79917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * by this instance. 80917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * 81917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * @return {@code non-null;} the register spec 82917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul */ 83917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul public RegisterSpec getLocal() { 84917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul return local; 85917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul } 86917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul 87917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul /** {@inheritDoc} */ 88917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul @Override 89917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul protected String argString() { 90917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul return local.toString(); 91917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul } 92917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul 93917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul /** {@inheritDoc} */ 94917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul @Override 95917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul protected String listingString0(boolean noteIndices) { 96917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul return "local-start " + localString(local); 97917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul } 98917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul} 99