1f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/* 2f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Copyright (C) 2007 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.RegisterSpecList; 20f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectimport com.android.dx.rop.code.SourcePosition; 21f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 22f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/** 23f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Instruction which has a single branch target. 24f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 25f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectpublic final class TargetInsn extends FixedSizeInsn { 2699409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project /** {@code non-null;} the branch target */ 27f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project private CodeAddress target; 28f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 29f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 30f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Constructs an instance. The output address of this instance is initially 3199409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project * unknown ({@code -1}), and the target is initially 3299409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project * {@code null}. 33f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 34f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * @param opcode the opcode; one of the constants from {@link Dops} 3599409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project * @param position {@code non-null;} source position 3699409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project * @param registers {@code non-null;} register list, including a 37f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * result register if appropriate (that is, registers may be either 38f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * ins or outs) 3999409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project * @param target {@code non-null;} the branch target 40f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 41f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public TargetInsn(Dop opcode, SourcePosition position, 42f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project RegisterSpecList registers, CodeAddress target) { 43f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project super(opcode, position, registers); 44f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 45f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project if (target == null) { 46f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project throw new NullPointerException("target == null"); 47f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 48f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 49f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project this.target = target; 50f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 51f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 52f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** {@inheritDoc} */ 53f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project @Override 54f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public DalvInsn withOpcode(Dop opcode) { 55f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project return new TargetInsn(opcode, getPosition(), getRegisters(), target); 56f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 57f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 58f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** {@inheritDoc} */ 59f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project @Override 60f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public DalvInsn withRegisters(RegisterSpecList registers) { 61f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project return new TargetInsn(getOpcode(), getPosition(), registers, target); 62f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 63f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 64f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 65f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Returns an instance that is just like this one, except that its 66f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * opcode has the opposite sense (as a test; e.g. a 6799409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project * {@code lt} test becomes a {@code ge}), and its branch 68f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * target is replaced by the one given, and all set-once values 69f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * associated with the class (such as its address) are reset. 70f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 7199409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project * @param target {@code non-null;} the new branch target 7299409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project * @return {@code non-null;} an appropriately-constructed instance 73f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 74f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public TargetInsn withNewTargetAndReversed(CodeAddress target) { 75f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project Dop opcode = getOpcode().getOppositeTest(); 76f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 77f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project return new TargetInsn(opcode, getPosition(), getRegisters(), target); 78f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 79f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 80f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 81f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Gets the unique branch target of this instruction. 82f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 8399409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project * @return {@code non-null;} the branch target 84f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 85f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public CodeAddress getTarget() { 86f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project return target; 87f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 88f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 89f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 90f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Gets the target address of this instruction. This is only valid 91f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * to call if the target instruction has been assigned an address, 92f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * and it is merely a convenient shorthand for 9399409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project * {@code getTarget().getAddress()}. 94f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 9599409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project * @return {@code >= 0;} the target address 96f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 97f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public int getTargetAddress() { 98f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project return target.getAddress(); 99f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 100f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 101f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 102f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Gets the branch offset of this instruction. This is only valid to 103f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * call if both this and the target instruction each has been assigned 104f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * an address, and it is merely a convenient shorthand for 10599409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project * {@code getTargetAddress() - getAddress()}. 106f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 107f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * @return the branch offset 108f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 109f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public int getTargetOffset() { 110f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project return target.getAddress() - getAddress(); 111f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 112f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 113f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 114f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Returns whether the target offset is known. 115f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 11699409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project * @return {@code true} if the target offset is known or 11799409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project * {@code false} if not 118f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 119f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public boolean hasTargetOffset() { 120f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project return hasAddress() && target.hasAddress(); 121f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 122f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 123f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** {@inheritDoc} */ 124f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project @Override 125f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project protected String argString() { 126f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project if (target == null) { 127f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project return "????"; 128f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 129f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 130f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project return target.identifierString(); 131f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 132f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project} 133