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.cf.code; 18f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 19f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectimport com.android.dx.rop.type.Type; 20f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectimport com.android.dx.rop.type.TypeBearer; 21f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectimport com.android.dx.util.Hex; 22f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 23f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/** 24f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Representation of a subroutine return address. In Java verification, 25f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * somewhat counterintuitively, the salient bit of information you need to 26f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * know about a return address is the <i>start address</i> of the subroutine 27f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * being returned from, not the address being returned <i>to</i>, so that's 28f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * what instances of this class hang onto. 29f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 30f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectpublic final class ReturnAddress implements TypeBearer { 3199409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project /** {@code >= 0;} the start address of the subroutine being returned from */ 32f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project private final int subroutineAddress; 33f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 34f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 35f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Constructs an instance. 36f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 3799409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project * @param subroutineAddress {@code >= 0;} the start address of the 38f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * subroutine being returned from 39f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 40f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public ReturnAddress(int subroutineAddress) { 41f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project if (subroutineAddress < 0) { 42f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project throw new IllegalArgumentException("subroutineAddress < 0"); 43f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 44f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 45f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project this.subroutineAddress = subroutineAddress; 46f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 47f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 48f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** {@inheritDoc} */ 49f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project @Override 50f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public String toString() { 51f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project return ("<addr:" + Hex.u2(subroutineAddress) + ">"); 52f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 53f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 54f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** {@inheritDoc} */ 55f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public String toHuman() { 56f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project return toString(); 57f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 58f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 59f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** {@inheritDoc} */ 60f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public Type getType() { 61f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project return Type.RETURN_ADDRESS; 62f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 63f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 64f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** {@inheritDoc} */ 65f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public TypeBearer getFrameType() { 66f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project return this; 67f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 68f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 69f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** {@inheritDoc} */ 70f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public int getBasicType() { 71f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project return Type.RETURN_ADDRESS.getBasicType(); 72f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 73f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 74f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** {@inheritDoc} */ 75f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public int getBasicFrameType() { 76f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project return Type.RETURN_ADDRESS.getBasicFrameType(); 77f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 78f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 79f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** {@inheritDoc} */ 80f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public boolean isConstant() { 81f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project return false; 82f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 83f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 84f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** {@inheritDoc} */ 85f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project @Override 86f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public boolean equals(Object other) { 87f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project if (!(other instanceof ReturnAddress)) { 88f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project return false; 89f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 90f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 91f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project return subroutineAddress == ((ReturnAddress) other).subroutineAddress; 92f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 93f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 94f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** {@inheritDoc} */ 95f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project @Override 96f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public int hashCode() { 97f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project return subroutineAddress; 98f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 99f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 100f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 101f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Gets the subroutine address. 102f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 10399409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project * @return {@code >= 0;} the subroutine address 104f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 105f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public int getSubroutineAddress() { 106f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project return subroutineAddress; 107f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 108f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project} 109