claw.wani.transformation.ll.loop

Class LoopExtraction

java.lang.Object

claw.shenron.transformation.Transformation

claw.wani.transformation.ClawTransformation

claw.wani.transformation.ll.loop.LoopExtraction

public class LoopExtraction
extends ClawTransformation

A LoopExtraction transformation is an independent transformation. The transformation consists of locating a loop in a function call and extract it. This loop is then wrapped around the function call and the parameters are demoted accordingly to the mapping options.

Author:

clementval

Field Summary

Fields inherited from class claw.wani.transformation.ClawTransformation

_claw

Constructor Summary

Constructors

Constructor and Description
LoopExtraction(ClawPragma directive) Constructs a new LoopExtraction triggered from a specific pragma.

Method Summary

Modifier and Type	Method and Description
boolean	analyze(XcodeProgram xcodeml, Translator translator) Check whether the transformation can be applied.
boolean	canBeTransformedWith(XcodeProgram xcodeml, Transformation other) Check whether the current transformation can be transformed together with the given transformation.
void	transform(XcodeProgram xcodeml, Translator translator, Transformation transformation) Apply the transformation.

Methods inherited from class claw.wani.transformation.ClawTransformation

getLanguageInfo, removePragma

Methods inherited from class claw.shenron.transformation.Transformation

abortOnFailedAnalysis, getDirective, getStartLine, isTransformed, setStartLine, transformed

Methods inherited from class java.lang.Object

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

Constructor Detail

LoopExtraction

public LoopExtraction(ClawPragma directive)
               throws IllegalDirectiveException

Constructs a new LoopExtraction triggered from a specific pragma.

Parameters:

directive - The directive that triggered the loop extraction transformation.

Throws:

IllegalDirectiveException - if something is wrong in the directive's options

Method Detail

analyze

public boolean analyze(XcodeProgram xcodeml,
                       Translator translator)

Check whether the transformation can be applied.

Specified by:

analyze in class Transformation

Parameters:

xcodeml - The XcodeML on which the transformations are applied.

translator - The translator used to applied the transformations.

Returns:

True if the transformation analysis succeeded. False otherwise.

transform

public void transform(XcodeProgram xcodeml,
                      Translator translator,
                      Transformation transformation)
               throws java.lang.Exception

Apply the transformation. A loop extraction is applied in the following steps: 1) Duplicate the function targeted by the transformation 2) Extract the loop body in the duplicated function and remove the loop. 3) Adapt function call and demote array references in the duplicated function body. 4) Optional: Add a LoopFusion transformation to the transformations' queue.

Specified by:

transform in class Transformation

Parameters:

xcodeml - The XcodeML on which the transformations are applied.

translator - The translator used to applied the transformations.

transformation - Only for dependent transformation. The other transformation part of the transformation.

Throws:

IllegalTransformationException - if the transformation cannot be applied.

java.lang.Exception

canBeTransformedWith

public boolean canBeTransformedWith(XcodeProgram xcodeml,
                                    Transformation other)

Description copied from class: Transformation

Check whether the current transformation can be transformed together with the given transformation. Useful only for dependent transformation.

Specified by:

canBeTransformedWith in class Transformation

Parameters:

xcodeml - The XcodeML on which the transformations are applied.

other - The other transformation part of the dependent transformation.

Returns:

Always false as independent transformation are applied one by one.

See Also:

Transformation.canBeTransformedWith(XcodeProgram, Transformation)