package de.unisiegen.tpml.core.expressions ;
import de.unisiegen.tpml.core.exceptions.NotOnlyFreeVariableException ;
import de.unisiegen.tpml.core.interfaces.DefaultExpressions ;
import de.unisiegen.tpml.core.interfaces.ExpressionOrType ;
import de.unisiegen.tpml.core.interfaces.SortedChildren ;
import de.unisiegen.tpml.core.latex.DefaultLatexCommand ;
import de.unisiegen.tpml.core.latex.LatexCommandList ;
import de.unisiegen.tpml.core.latex.LatexStringBuilder ;
import de.unisiegen.tpml.core.latex.LatexStringBuilderFactory ;
import de.unisiegen.tpml.core.prettyprinter.PrettyStringBuilder ;
import de.unisiegen.tpml.core.prettyprinter.PrettyStringBuilderFactory ;
import de.unisiegen.tpml.core.typechecker.TypeSubstitution ;
/**
* Instances of this class are used to represent infix operations, which act as
* syntactic sugar for applications. The string representation of an infix
* operation is <code>e1 op e2</code> where <code>op</code> is a binary
* operator.
*
* @author Benedikt Meurer
* @author Christian Fehler
* @version $Rev:1053 $
* @see Application
* @see BinaryOperator
* @see Expression
*/
public final class InfixOperation extends Expression implements
DefaultExpressions , SortedChildren
{
/**
* Indeces of the child {@link Expression}s.
*/
private static final int [ ] INDICES_E = new int [ ]
{ - 1 , 1 , 2 } ;
/**
* String for the case that e1 is null.
*/
private static final String E1_NULL = "e1 is null" ; //$NON-NLS-1$
/**
* String for the case that e2 is null.
*/
private static final String E2_NULL = "e2 is null" ; //$NON-NLS-1$
/**
* String for the case that op is null.
*/
private static final String OP_NULL = "op is null" ; //$NON-NLS-1$
/**
* The caption of this {@link Expression}.
*/
private static final String CAPTION = Expression
.getCaption ( InfixOperation.class ) ;
/**
* Returns a set of needed latex commands for this latex printable object.
*
* @return A set of needed latex commands for this latex printable object.
*/
public static LatexCommandList getLatexCommandsStatic ( )
{
LatexCommandList commands = new LatexCommandList ( ) ;
commands.add ( new DefaultLatexCommand ( LATEX_INFIX_OPERATION , 3 ,
"\\color{" + LATEX_COLOR_EXPRESSION + "}#2\\ #1\\ #3" , "op" , "e1" , //$NON-NLS-1$//$NON-NLS-2$//$NON-NLS-3$ //$NON-NLS-4$
"e2" ) ) ; //$NON-NLS-1$
return commands ;
}
/**
* The expressions.
*/
private Expression [ ] expressions ;
/**
* Allocates a new <code>InfixOperation</code> with the specified
* parameters.
*
* @param pBinaryOperator the binary operator.
* @param pExpression1 the first operand.
* @param pExpression2 the second operand.
* @throws NullPointerException if <code>op</code>, <code>e1</code> or
* <code>e2</code> is <code>null</code>.
*/
public InfixOperation ( BinaryOperator pBinaryOperator ,
Expression pExpression1 , Expression pExpression2 )
{
if ( pBinaryOperator == null )
{
throw new NullPointerException ( OP_NULL ) ;
}
if ( pExpression1 == null )
{
throw new NullPointerException ( E1_NULL ) ;
}
if ( pExpression2 == null )
{
throw new NullPointerException ( E2_NULL ) ;
}
this.expressions = new Expression [ ]
{ pBinaryOperator , pExpression1 , pExpression2 } ;
this.expressions [ 0 ].setParent ( this ) ;
this.expressions [ 1 ].setParent ( this ) ;
this.expressions [ 2 ].setParent ( this ) ;
}
/**
* Allocates a new <code>InfixOperation</code> with the specified
* parameters.
*
* @param pBinaryOperator the binary operator.
* @param pExpression1 the first operand.
* @param pExpression2 the second operand.
* @param pParserStartOffset The start offset of this {@link Expression} in
* the source code.
* @param pParserEndOffset The end offset of this {@link Expression} in the
* source code.
* @throws NullPointerException if <code>op</code>, <code>e1</code> or
* <code>e2</code> is <code>null</code>.
*/
public InfixOperation ( BinaryOperator pBinaryOperator ,
Expression pExpression1 , Expression pExpression2 ,
int pParserStartOffset , int pParserEndOffset )
{
this ( pBinaryOperator , pExpression1 , pExpression2 ) ;
this.parserStartOffset = pParserStartOffset ;
this.parserEndOffset = pParserEndOffset ;
}
/**
* {@inheritDoc}
*
* @see Expression#clone()
*/
@ Override
public InfixOperation clone ( )
{
return new InfixOperation ( ( BinaryOperator ) this.expressions [ 0 ]
.clone ( ) , this.expressions [ 1 ].clone ( ) , this.expressions [ 2 ]
.clone ( ) ) ;
}
/**
* {@inheritDoc}
*
* @see Expression#equals(Object)
*/
@ Override
public boolean equals ( Object pObject )
{
if ( pObject instanceof InfixOperation )
{
InfixOperation other = ( InfixOperation ) pObject ;
return ( ( this.expressions [ 0 ].equals ( other.expressions [ 0 ] ) )
&& ( this.expressions [ 1 ].equals ( other.expressions [ 1 ] ) ) && ( this.expressions [ 2 ]
.equals ( other.expressions [ 2 ] ) ) ) ;
}
return false ;
}
/**
* {@inheritDoc}
*/
@ Override
public String getCaption ( )
{
return CAPTION ;
}
/**
* Returns the first operand.
*
* @return the first operand.
* @see #getOp()
* @see #getE2()
*/
public Expression getE1 ( )
{
return this.expressions [ 1 ] ;
}
/**
* Returns the second operand.
*
* @return the second operand.
* @see #getOp()
* @see #getE1()
*/
public Expression getE2 ( )
{
return this.expressions [ 2 ] ;
}
/**
* Returns the sub expressions.
*
* @return the sub expressions.
*/
public Expression [ ] getExpressions ( )
{
return this.expressions ;
}
/**
* Returns the indices of the child {@link Expression}s.
*
* @return The indices of the child {@link Expression}s.
*/
public int [ ] getExpressionsIndex ( )
{
return INDICES_E ;
}
/**
* Returns a set of needed latex commands for this latex printable object.
*
* @return A set of needed latex commands for this latex printable object.
*/
@ Override
public LatexCommandList getLatexCommands ( )
{
LatexCommandList commands = super.getLatexCommands ( ) ;
commands.add ( getLatexCommandsStatic ( ) ) ;
return commands ;
}
/**
* Returns the binary operator that is applied to <code>e1</code> and
* <code>e2</code>.
*
* @return the binary operator.
* @see #getE1()
* @see #getE2()
*/
public BinaryOperator getOp ( )
{
return ( BinaryOperator ) this.expressions [ 0 ] ;
}
/**
* Returns the {@link Expression}s in the right sorting.
*
* @return The {@link Expression}s in the right sorting.
* @see SortedChildren#getSortedChildren()
*/
public ExpressionOrType [ ] getSortedChildren ( )
{
ExpressionOrType [ ] result = new ExpressionOrType [ ]
{ this.expressions [ 1 ] , this.expressions [ 0 ] , this.expressions [ 2 ] } ;
return result ;
}
/**
* {@inheritDoc}
*
* @see Expression#hashCode()
*/
@ Override
public int hashCode ( )
{
return this.expressions [ 0 ].hashCode ( )
+ this.expressions [ 1 ].hashCode ( )
+ this.expressions [ 2 ].hashCode ( ) ;
}
/**
* {@inheritDoc}
*
* @see Expression#substitute(Identifier, Expression)
*/
@ Override
public InfixOperation substitute ( Identifier pId , Expression pExpression )
{
if ( pExpression.getIdentifierFreeNotOnlyVariable ( ) )
{
throw new NotOnlyFreeVariableException ( ) ;
}
Expression newE1 = this.expressions [ 1 ].substitute ( pId , pExpression ) ;
Expression newE2 = this.expressions [ 2 ].substitute ( pId , pExpression ) ;
return new InfixOperation ( ( BinaryOperator ) this.expressions [ 0 ] ,
newE1 , newE2 ) ;
}
/**
* {@inheritDoc}
*
* @see Expression#substitute(TypeSubstitution)
*/
@ Override
public InfixOperation substitute ( TypeSubstitution pTypeSubstitution )
{
Expression newE1 = this.expressions [ 1 ].substitute ( pTypeSubstitution ) ;
Expression newE2 = this.expressions [ 2 ].substitute ( pTypeSubstitution ) ;
return new InfixOperation ( ( BinaryOperator ) this.expressions [ 0 ] ,
newE1 , newE2 ) ;
}
/**
* {@inheritDoc}
*
* @see Expression#toLatexStringBuilder(LatexStringBuilderFactory,int)
*/
@ Override
public LatexStringBuilder toLatexStringBuilder (
LatexStringBuilderFactory pLatexStringBuilderFactory , int pIndent )
{
LatexStringBuilder builder = pLatexStringBuilderFactory.newBuilder (
( ( BinaryOperator ) this.expressions [ 0 ] ).getPrettyPriority ( ) ,
LATEX_INFIX_OPERATION , pIndent , this.toPrettyString ( ).toString ( ) ,
this.expressions [ 0 ].toPrettyString ( ).toString ( ) ,
this.expressions [ 1 ].toPrettyString ( ).toString ( ) ,
this.expressions [ 2 ].toPrettyString ( ).toString ( ) ) ;
builder.addBuilder ( this.expressions [ 0 ].toLatexStringBuilder (
pLatexStringBuilderFactory , pIndent + LATEX_INDENT ) ,
( ( BinaryOperator ) this.expressions [ 0 ] ).getPrettyPriority ( ) ) ;
builder.addBuilder ( this.expressions [ 1 ].toLatexStringBuilder (
pLatexStringBuilderFactory , pIndent + LATEX_INDENT ) ,
( ( BinaryOperator ) this.expressions [ 0 ] ).getPrettyPriority ( ) ) ;
builder.addBreak ( ) ;
builder
.addBuilder (
this.expressions [ 2 ].toLatexStringBuilder (
pLatexStringBuilderFactory , pIndent + LATEX_INDENT ) ,
( ( BinaryOperator ) this.expressions [ 0 ] ).getPrettyPriority ( ) + 1 ) ;
return builder ;
}
/**
* {@inheritDoc}
*
* @see Expression#toPrettyStringBuilder(PrettyStringBuilderFactory)
*/
@ Override
public PrettyStringBuilder toPrettyStringBuilder (
PrettyStringBuilderFactory pPrettyStringBuilderFactory )
{
if ( this.prettyStringBuilder == null )
{
this.prettyStringBuilder = pPrettyStringBuilderFactory.newBuilder ( this ,
( ( BinaryOperator ) this.expressions [ 0 ] ).getPrettyPriority ( ) ) ;
this.prettyStringBuilder.addBuilder ( this.expressions [ 1 ]
.toPrettyStringBuilder ( pPrettyStringBuilderFactory ) ,
( ( BinaryOperator ) this.expressions [ 0 ] ).getPrettyPriority ( ) ) ;
this.prettyStringBuilder.addText ( PRETTY_SPACE ) ;
this.prettyStringBuilder.addBuilder ( this.expressions [ 0 ]
.toPrettyStringBuilder ( pPrettyStringBuilderFactory ) ,
( ( BinaryOperator ) this.expressions [ 0 ] ).getPrettyPriority ( ) ) ;
this.prettyStringBuilder.addText ( PRETTY_SPACE ) ;
this.prettyStringBuilder.addBreak ( ) ;
this.prettyStringBuilder
.addBuilder ( this.expressions [ 2 ]
.toPrettyStringBuilder ( pPrettyStringBuilderFactory ) ,
( ( BinaryOperator ) this.expressions [ 0 ] )
.getPrettyPriority ( ) + 1 ) ;
}
return this.prettyStringBuilder ;
}
}