org.apache.commons.nabla.algorithmic.forward.instructions
Class DReturnTransformer

java.lang.Object
  org.apache.commons.nabla.algorithmic.forward.instructions.DReturnTransformer

All Implemented Interfaces:

InstructionsTransformer

public class DReturnTransformer
extends Object
implements InstructionsTransformer

Differentiation transformer for DRETURN instructions.

DRETURN instructions are replaced by instructions that build a DifferentialPair instance from the expanded differential pair on operand stack head and an ARETURN instruction returning this instance.

Method Summary

static InstructionsTransformer	getInstance() Get the singleton instance.
org.objectweb.asm.tree.InsnList	getReplacement(org.objectweb.asm.tree.AbstractInsnNode insn, MethodDifferentiator methodDifferentiator) Get the replacement instructions.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getInstance

public static InstructionsTransformer getInstance()

Get the singleton instance.

We use here the Initialization on Demand Holder idiom.

Returns:

the singleton instance

getReplacement

public org.objectweb.asm.tree.InsnList getReplacement(org.objectweb.asm.tree.AbstractInsnNode insn,
                                                      MethodDifferentiator methodDifferentiator)
                                               throws DifferentiationException

Get the replacement instructions.

Specified by:

getReplacement in interface InstructionsTransformer

Parameters:

insn - original instruction

methodDifferentiator - method differentiator driving this transformer

Returns:

replacement instructions

Throws:

DifferentiationException - if the method differentiator cannot provide a temporary variable