com.codemesh.terp.ant.compiler.cpp
Class ExceptionsOption

java.lang.Object
  com.codemesh.terp.ant.compiler.AbstractCompilerOption<C>
      com.codemesh.terp.ant.compiler.BooleanCompilerOption<CppCompiler>
          com.codemesh.terp.ant.compiler.cpp.ExceptionsOption

All Implemented Interfaces:

CompilerOption<CppCompiler>

public class ExceptionsOption
extends BooleanCompilerOption<CppCompiler>

The option governing whether exceptions are supported or not. Not all C++ compilers support the explicit enabling/disabling of exceptions via a compielr switch, so this is not a completely portable option.

Constructor Summary

ExceptionsOption()

Method Summary

void	addCommands(java.util.List<java.lang.String> commandList, CppCompiler compiler, CompilerPhase phase) Adds the compiler switches repreesnted by this option to the list of switches.
boolean	appliesTo(CppCompiler compiler, CompilerPhase phase) Returns true if this compiler option applies to the given compiler and compiler phase.
java.lang.String	getSynchronous()
void	setSynchronous(java.lang.String sync) Specify synchronous exception handling for MSVC++ and Intel C++ on Windows.

Methods inherited from class com.codemesh.terp.ant.compiler.BooleanCompilerOption

getValue, isEnabled, setValue

Methods inherited from class com.codemesh.terp.ant.compiler.AbstractCompilerOption

expand, expand, getIf, getProject, getUnless, quoteIfNecessary, satisfies, setIf, setProject, setUnless

Methods inherited from class java.lang.Object

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

Constructor Detail

ExceptionsOption

public ExceptionsOption()

Method Detail

setSynchronous

public void setSynchronous(java.lang.String sync)

Specify synchronous exception handling for MSVC++ and Intel C++ on Windows. Windows C++ compilers support two exception handling models, synchronous and asynchronous. The default is asynchronous but you can use this attribute to override this behavior. Synchronous translates to a /EHsc option, asynchronous translates to a /EHa option.

Parameters:

sync - a boolean expression.

getSynchronous

public java.lang.String getSynchronous()

addCommands

public void addCommands(java.util.List<java.lang.String> commandList,
                        CppCompiler compiler,
                        CompilerPhase phase)

Adds the compiler switches repreesnted by this option to the list of switches. Some compiler options may result in more than one switch being added to a compiler invocation. Other compiler options may result in different options being added in different phases (compilation vs. linking) of the build.

This method is called by the compiler repeatedly with different values for the compiler phase to account for these possibilities.

Parameters:

commandList - the list to which the compiler switches represented by this option (if any) are added.

compiler - the compiler for which we're doing this.

phase - the compiler phase in wihch we're doing this.

appliesTo

public boolean appliesTo(CppCompiler compiler,
                         CompilerPhase phase)

Returns true if this compiler option applies to the given compiler and compiler phase. Not every option has switches to contribute for every compiler and every compilation phase. This method allows a quick, inexpensive check to filter out potentially more expensive calls later on.

Parameters:

compiler - the compiler for which we're asking.

phase - the compiler phase we're executing.

Returns: