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.RegisterSpecList; 20917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgulimport com.android.dexgen.rop.code.SourcePosition; 21917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgulimport com.android.dexgen.util.AnnotatedOutput; 22917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul 23917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul/** 24917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * Base class for instructions which are of a fixed code size and which use {@link InsnFormat} methods to write themselves. This 25917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * includes most — but not all — instructions. 26917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul */ 27917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgulpublic abstract class FixedSizeInsn extends DalvInsn { 28917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul /** 29917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * Constructs an instance. The output address of this instance is initially 30917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * unknown ({@code -1}). 31917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * 32917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * <p><b>Note:</b> In the unlikely event that an instruction takes 33917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * absolutely no registers (e.g., a {@code nop} or a 34917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * no-argument no-result * static method call), then the given 35917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * register list may be passed as {@link 36917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * RegisterSpecList#EMPTY}.</p> 37917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * 38917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * @param opcode the opcode; one of the constants from {@link Dops} 39917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * @param position {@code non-null;} source position 40917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * @param registers {@code non-null;} register list, including a 41917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * result register if appropriate (that is, registers may be either 42917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul * ins or outs) 43917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul */ 44917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul public FixedSizeInsn(Dop opcode, SourcePosition position, 45917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul RegisterSpecList registers) { 46917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul super(opcode, position, registers); 47917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul } 48917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul 49917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul /** {@inheritDoc} */ 50917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul @Override 51917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul public final int codeSize() { 52917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul return getOpcode().getFormat().codeSize(); 53917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul } 54917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul 55917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul /** {@inheritDoc} */ 56917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul @Override 57917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul public final void writeTo(AnnotatedOutput out) { 58917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul getOpcode().getFormat().writeTo(out, this); 59917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul } 60917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul 61917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul /** {@inheritDoc} */ 62917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul @Override 63917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul public final DalvInsn withRegisterOffset(int delta) { 64917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul return withRegisters(getRegisters().withOffset(delta)); 65917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul } 66917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul 67917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul /** {@inheritDoc} */ 68917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul @Override 69917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul protected final String listingString0(boolean noteIndices) { 70917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul return getOpcode().getFormat().listingString(this, noteIndices); 71917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul } 72917cb222329ee8c035c3ffaf947e4265761b9367Piotr Gurgul} 73