1579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson/* 2579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * Copyright (C) 2007 The Android Open Source Project 3579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * 4579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * Licensed under the Apache License, Version 2.0 (the "License"); 5579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * you may not use this file except in compliance with the License. 6579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * You may obtain a copy of the License at 7579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * 8579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * http://www.apache.org/licenses/LICENSE-2.0 9579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * 10579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * Unless required by applicable law or agreed to in writing, software 11579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * distributed under the License is distributed on an "AS IS" BASIS, 12579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * See the License for the specific language governing permissions and 14579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * limitations under the License. 15579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson */ 16579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson 17579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilsonpackage com.android.dx.dex.code; 18579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson 19579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilsonimport com.android.dx.rop.code.RegisterSpecList; 20579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilsonimport com.android.dx.rop.code.SourcePosition; 21579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilsonimport com.android.dx.util.AnnotatedOutput; 22579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson 23579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson/** 24579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * Base class for instructions which are of a fixed code size and 25579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * which use {@link InsnFormat} methods to write themselves. This 26579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * includes most — but not all — instructions. 27579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson */ 28579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilsonpublic abstract class FixedSizeInsn extends DalvInsn { 29579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson /** 30579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * Constructs an instance. The output address of this instance is initially 31579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * unknown ({@code -1}). 32579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * 33579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * <p><b>Note:</b> In the unlikely event that an instruction takes 34579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * absolutely no registers (e.g., a {@code nop} or a 35579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * no-argument no-result * static method call), then the given 36579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * register list may be passed as {@link 37579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * RegisterSpecList#EMPTY}.</p> 38579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * 39579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * @param opcode the opcode; one of the constants from {@link Dops} 40579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * @param position {@code non-null;} source position 41579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * @param registers {@code non-null;} register list, including a 42579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * result register if appropriate (that is, registers may be either 43579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * ins or outs) 44579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson */ 45579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson public FixedSizeInsn(Dop opcode, SourcePosition position, 46579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson RegisterSpecList registers) { 47579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson super(opcode, position, registers); 48579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson } 49579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson 50579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson /** {@inheritDoc} */ 51579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson @Override 52579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson public final int codeSize() { 53579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson return getOpcode().getFormat().codeSize(); 54579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson } 55579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson 56579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson /** {@inheritDoc} */ 57579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson @Override 58579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson public final void writeTo(AnnotatedOutput out) { 59579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson getOpcode().getFormat().writeTo(out, this); 60579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson } 61579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson 62579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson /** {@inheritDoc} */ 63579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson @Override 64579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson public final DalvInsn withRegisterOffset(int delta) { 65579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson return withRegisters(getRegisters().withOffset(delta)); 66579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson } 67579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson 68579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson /** {@inheritDoc} */ 69579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson @Override 70579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson protected final String listingString0(boolean noteIndices) { 71579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson return getOpcode().getFormat().listingString(this, noteIndices); 72579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson } 73579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson} 74