soot.asm.Operand Maven / Gradle / Ivy

package soot.asm;

/*-
 * #%L
 * Soot - a J*va Optimization Framework
 * %%
 * Copyright (C) 1997 - 2014 Raja Vallee-Rai and others
 * %%
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Lesser General Public License as
 * published by the Free Software Foundation, either version 2.1 of the
 * License, or (at your option) any later version.
 * 
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Lesser Public License for more details.
 * 
 * You should have received a copy of the GNU General Lesser Public
 * License along with this program.  If not, see
 * .
 * #L%
 */

import java.util.ArrayList;
import java.util.List;

import org.objectweb.asm.tree.AbstractInsnNode;

import soot.Local;
import soot.Value;
import soot.ValueBox;

/**
 * Stack operand.
 * 
 * @author Aaloan Miftah
 */
final class Operand {

  final AbstractInsnNode insn;
  final Value value;
  Local stack;
  private Object boxes;

  /**
   * Constructs a new stack operand.
   * 
   * @param insn
   *          the instruction that produced this operand.
   * @param value
   *          the generated value.
   */
  Operand(AbstractInsnNode insn, Value value) {
    this.insn = insn;
    this.value = value;
  }

  /**
   * Removes a value box from this operand.
   * 
   * @param vb
   *          the value box.
   */
  @SuppressWarnings("unchecked")
  void removeBox(ValueBox vb) {
    if (vb == null) {
      return;
    }
    if (boxes == vb) {
      boxes = null;
    } else if (boxes instanceof List) {
      List list = (List) boxes;
      list.remove(vb);
    }
  }

  /**
   * Adds a value box to this operand.
   * 
   * @param vb
   *          the value box.
   */
  @SuppressWarnings("unchecked")
  void addBox(ValueBox vb) {
    if (boxes instanceof List) {
      List list = (List) boxes;
      list.add(vb);
    } else if (boxes instanceof ValueBox) {
      ValueBox ovb = (ValueBox) boxes;
      List list = new ArrayList();
      list.add(ovb);
      list.add(vb);
      boxes = list;
    } else {
      boxes = vb;
    }
  }

  /**
   * Updates all value boxes registered to this operand.
   */
  @SuppressWarnings("unchecked")
  void updateBoxes() {
    Value val = stackOrValue();
    if (boxes instanceof List) {
      for (ValueBox vb : (List) boxes) {
        vb.setValue(val);
      }
    } else if (boxes instanceof ValueBox) {
      ((ValueBox) boxes).setValue(val);
    }
  }

  /**
   * @param 
   *          type of value to cast to.
   * @return the value.
   */
  @SuppressWarnings("unchecked")
   A value() {
    return (A) value;
  }

  /**
   * @return either the stack local allocated for this operand, or its value.
   */
  Value stackOrValue() {
    Local s = stack;
    return s == null ? value : s;
  }

  /**
   * Determines if this operand is equal to another operand.
   * 
   * @param other
   *          the other operand.
   * @return {@code true} if this operand is equal to another operand, {@code false} otherwise.
   */
  boolean equivTo(Operand other) {
    if (other.value == null && value == null) {
      return true;
    }
    return stackOrValue().equivTo(other.stackOrValue());
  }

  @Override
  public boolean equals(Object other) {
    return other instanceof Operand && equivTo((Operand) other);
  }
}