--- a/carbidesdk/com.nokia.carbide.cpp.sdk.doc.user/reference/api/com/nokia/carbide/cpp/epoc/engine/preprocessor/IViewFilter.html Tue Jul 27 15:20:28 2010 -0500
+++ b/carbidesdk/com.nokia.carbide.cpp.sdk.doc.user/reference/api/com/nokia/carbide/cpp/epoc/engine/preprocessor/IViewFilter.html Tue Jul 27 15:28:19 2010 -0500
@@ -1,330 +1,330 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
-<!--NewPage-->
-<HTML>
-<HEAD>
-<!-- Generated by javadoc (build 1.5.0_15) on Tue Jan 06 17:31:54 CST 2009 -->
-<META http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
-<TITLE>
-IViewFilter (Carbide.c++ SDK API Reference)
-</TITLE>
-
-<META NAME="keywords" CONTENT="com.nokia.carbide.cpp.epoc.engine.preprocessor.IViewFilter interface">
-
-<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../../../../stylesheet.css" TITLE="Style">
-
-<SCRIPT type="text/javascript">
-function windowTitle()
-{
- parent.document.title="IViewFilter (Carbide.c++ SDK API Reference)";
-}
-</SCRIPT>
-<NOSCRIPT>
-</NOSCRIPT>
-
-</HEAD>
-
-<BODY BGCOLOR="white" onload="windowTitle();">
-
-
-<!-- ========= START OF TOP NAVBAR ======= -->
-<A NAME="navbar_top"><!-- --></A>
-<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
-<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
-<TR>
-<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
-<A NAME="navbar_top_firstrow"><!-- --></A>
-<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
- <TR ALIGN="center" VALIGN="top">
- <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
- <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
- <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
- <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/IViewFilter.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
- <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
- <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
- <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../../../index-files/index-1.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
- <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
- </TR>
-</TABLE>
-</TD>
-<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
-<b>Carbide.c++</b></EM>
-</TD>
-</TR>
-
-<TR>
-<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
- <A HREF="../../../../../../../com/nokia/carbide/cpp/epoc/engine/preprocessor/ITranslationUnitProvider.html" title="interface in com.nokia.carbide.cpp.epoc.engine.preprocessor"><B>PREV CLASS</B></A>
- <A HREF="../../../../../../../com/nokia/carbide/cpp/epoc/engine/preprocessor/SharedNodesViewFilter.html" title="class in com.nokia.carbide.cpp.epoc.engine.preprocessor"><B>NEXT CLASS</B></A></FONT></TD>
-<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
- <A HREF="../../../../../../../index.html?com/nokia/carbide/cpp/epoc/engine/preprocessor/IViewFilter.html" target="_top"><B>FRAMES</B></A>
- <A HREF="IViewFilter.html" target="_top"><B>NO FRAMES</B></A>
- <SCRIPT type="text/javascript">
- <!--
- if(window==top) {
- document.writeln('<A HREF="../../../../../../../allclasses-noframe.html"><B>All Classes</B></A>');
- }
- //-->
-</SCRIPT>
-<NOSCRIPT>
- <A HREF="../../../../../../../allclasses-noframe.html"><B>All Classes</B></A>
-</NOSCRIPT>
-
-
-</FONT></TD>
-</TR>
-<TR>
-<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
- SUMMARY: NESTED | FIELD | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD>
-<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
-DETAIL: FIELD | CONSTR | <A HREF="#method_detail">METHOD</A></FONT></TD>
-</TR>
-</TABLE>
-<A NAME="skip-navbar_top"></A>
-<!-- ========= END OF TOP NAVBAR ========= -->
-
-<HR>
-<!-- ======== START OF CLASS DATA ======== -->
-<H2>
-<FONT SIZE="-1">
-com.nokia.carbide.cpp.epoc.engine.preprocessor</FONT>
-<BR>
-Interface IViewFilter</H2>
-<DL>
-<DT><B>All Known Implementing Classes:</B> <DD><A HREF="../../../../../../../com/nokia/carbide/cdt/builder/AcceptedBuildContextNodesViewFilter.html" title="class in com.nokia.carbide.cdt.builder">AcceptedBuildContextNodesViewFilter</A>, <A HREF="../../../../../../../com/nokia/carbide/cpp/epoc/engine/preprocessor/AcceptedNodesViewFilter.html" title="class in com.nokia.carbide.cpp.epoc.engine.preprocessor">AcceptedNodesViewFilter</A>, <A HREF="../../../../../../../com/nokia/carbide/cpp/epoc/engine/preprocessor/AllNodesViewFilter.html" title="class in com.nokia.carbide.cpp.epoc.engine.preprocessor">AllNodesViewFilter</A>, <A HREF="../../../../../../../com/nokia/carbide/cpp/epoc/engine/preprocessor/SharedNodesViewFilter.html" title="class in com.nokia.carbide.cpp.epoc.engine.preprocessor">SharedNodesViewFilter</A></DD>
-</DL>
-<HR>
-<DL>
-<DT><PRE>public interface <B>IViewFilter</B></DL>
-</PRE>
-
-<P>
-This interface, implemented by a client or by a standard implementation,
- is used to determine how to interpret preprocessor conditionals and macros
- when determining what content to expose from a preprocessor DOM.
-<P>
-
-<P>
-<DL>
-<DT><B>See Also:</B><DD><A HREF="../../../../../../../com/nokia/carbide/cpp/epoc/engine/model/IViewConfiguration.html" title="interface in com.nokia.carbide.cpp.epoc.engine.model"><CODE>IViewConfiguration</CODE></A>,
-<CODE>IPreprocessor</CODE></DL>
-<HR>
-
-<P>
-
-<!-- ========== METHOD SUMMARY =========== -->
-
-<A NAME="method_summary"><!-- --></A>
-<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
-<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
-<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
-<B>Method Summary</B></FONT></TH>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE> boolean</CODE></FONT></TD>
-<TD><CODE><B><A HREF="../../../../../../../com/nokia/carbide/cpp/epoc/engine/preprocessor/IViewFilter.html#combineBranches()">combineBranches</A></B>()</CODE>
-
-<BR>
- when #evaluteConditionals() returns true, then if true, then both true
- and false branches of a test are included.</TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE> boolean</CODE></FONT></TD>
-<TD><CODE><B><A HREF="../../../../../../../com/nokia/carbide/cpp/epoc/engine/preprocessor/IViewFilter.html#evaluateConditionalStatements()">evaluateConditionalStatements</A></B>()</CODE>
-
-<BR>
- if true, use macro values to evaluate #if/etc nodes and include the
- contents in the succeeding branch; else, conditionals are skipped
- entirely</TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE> boolean</CODE></FONT></TD>
-<TD><CODE><B><A HREF="../../../../../../../com/nokia/carbide/cpp/epoc/engine/preprocessor/IViewFilter.html#evaluateUnconditionalStatements()">evaluateUnconditionalStatements</A></B>()</CODE>
-
-<BR>
- if true, then nodes outside #if/etc are kept, else, they are skipped
- entirely</TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE> boolean</CODE></FONT></TD>
-<TD><CODE><B><A HREF="../../../../../../../com/nokia/carbide/cpp/epoc/engine/preprocessor/IViewFilter.html#expandVariantMacros()">expandVariantMacros</A></B>()</CODE>
-
-<BR>
- • variant macro: a macro whose value is determined to differ between
- configurations, either by coming from a set of fixed macros or by being
- defined inside #ifs in the translation unit
-
- • if true, expand variant
- macros when encountered in macro expressions and statements; else,
- statements containing variant macros will be filtered out.</TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE> boolean</CODE></FONT></TD>
-<TD><CODE><B><A HREF="../../../../../../../com/nokia/carbide/cpp/epoc/engine/preprocessor/IViewFilter.html#invertSuccess()">invertSuccess</A></B>()</CODE>
-
-<BR>
- when #evaluteConditionals() returns true, then, if true, filter out
- contents from successful tests and keep contents from failing tests</TD>
-</TR>
-</TABLE>
-
-<P>
-
-<!-- ============ METHOD DETAIL ========== -->
-
-<A NAME="method_detail"><!-- --></A>
-<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
-<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
-<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
-<B>Method Detail</B></FONT></TH>
-</TR>
-</TABLE>
-
-<A NAME="evaluateUnconditionalStatements()"><!-- --></A><H3>
-evaluateUnconditionalStatements</H3>
-<PRE>
-boolean <B>evaluateUnconditionalStatements</B>()</PRE>
-<DL>
-<DD>if true, then nodes outside #if/etc are kept, else, they are skipped
- entirely
-<P>
-<DD><DL>
-
-<DT><B>Returns:</B><DD></DL>
-</DD>
-</DL>
-<HR>
-
-<A NAME="evaluateConditionalStatements()"><!-- --></A><H3>
-evaluateConditionalStatements</H3>
-<PRE>
-boolean <B>evaluateConditionalStatements</B>()</PRE>
-<DL>
-<DD>if true, use macro values to evaluate #if/etc nodes and include the
- contents in the succeeding branch; else, conditionals are skipped
- entirely
-<P>
-<DD><DL>
-
-<DT><B>Returns:</B><DD></DL>
-</DD>
-</DL>
-<HR>
-
-<A NAME="invertSuccess()"><!-- --></A><H3>
-invertSuccess</H3>
-<PRE>
-boolean <B>invertSuccess</B>()</PRE>
-<DL>
-<DD>when #evaluteConditionals() returns true, then, if true, filter out
- contents from successful tests and keep contents from failing tests
-<P>
-<DD><DL>
-
-<DT><B>Returns:</B><DD></DL>
-</DD>
-</DL>
-<HR>
-
-<A NAME="combineBranches()"><!-- --></A><H3>
-combineBranches</H3>
-<PRE>
-boolean <B>combineBranches</B>()</PRE>
-<DL>
-<DD>when #evaluteConditionals() returns true, then if true, then both true
- and false branches of a test are included.
-<P>
-<DD><DL>
-
-<DT><B>Returns:</B><DD></DL>
-</DD>
-</DL>
-<HR>
-
-<A NAME="expandVariantMacros()"><!-- --></A><H3>
-expandVariantMacros</H3>
-<PRE>
-boolean <B>expandVariantMacros</B>()</PRE>
-<DL>
-<DD>• variant macro: a macro whose value is determined to differ between
- configurations, either by coming from a set of fixed macros or by being
- defined inside #ifs in the translation unit
- <p>
- • if true, expand variant
- macros when encountered in macro expressions and statements; else,
- statements containing variant macros will be filtered out. (Macros in #if
- expressions are outside the scope of this query.)
-<P>
-<DD><DL>
-
-<DT><B>Returns:</B><DD></DL>
-</DD>
-</DL>
-<!-- ========= END OF CLASS DATA ========= -->
-<HR>
-
-
-<!-- ======= START OF BOTTOM NAVBAR ====== -->
-<A NAME="navbar_bottom"><!-- --></A>
-<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
-<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
-<TR>
-<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
-<A NAME="navbar_bottom_firstrow"><!-- --></A>
-<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
- <TR ALIGN="center" VALIGN="top">
- <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
- <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
- <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
- <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/IViewFilter.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
- <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
- <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
- <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../../../index-files/index-1.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
- <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
- </TR>
-</TABLE>
-</TD>
-<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
-<b>Carbide.c++</b></EM>
-</TD>
-</TR>
-
-<TR>
-<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
- <A HREF="../../../../../../../com/nokia/carbide/cpp/epoc/engine/preprocessor/ITranslationUnitProvider.html" title="interface in com.nokia.carbide.cpp.epoc.engine.preprocessor"><B>PREV CLASS</B></A>
- <A HREF="../../../../../../../com/nokia/carbide/cpp/epoc/engine/preprocessor/SharedNodesViewFilter.html" title="class in com.nokia.carbide.cpp.epoc.engine.preprocessor"><B>NEXT CLASS</B></A></FONT></TD>
-<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
- <A HREF="../../../../../../../index.html?com/nokia/carbide/cpp/epoc/engine/preprocessor/IViewFilter.html" target="_top"><B>FRAMES</B></A>
- <A HREF="IViewFilter.html" target="_top"><B>NO FRAMES</B></A>
- <SCRIPT type="text/javascript">
- <!--
- if(window==top) {
- document.writeln('<A HREF="../../../../../../../allclasses-noframe.html"><B>All Classes</B></A>');
- }
- //-->
-</SCRIPT>
-<NOSCRIPT>
- <A HREF="../../../../../../../allclasses-noframe.html"><B>All Classes</B></A>
-</NOSCRIPT>
-
-
-</FONT></TD>
-</TR>
-<TR>
-<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
- SUMMARY: NESTED | FIELD | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD>
-<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
-DETAIL: FIELD | CONSTR | <A HREF="#method_detail">METHOD</A></FONT></TD>
-</TR>
-</TABLE>
-<A NAME="skip-navbar_bottom"></A>
-<!-- ======== END OF BOTTOM NAVBAR ======= -->
-
-<HR>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-</BODY>
-</HTML>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!--NewPage-->
+<HTML>
+<HEAD>
+<!-- Generated by javadoc (build 1.5.0_15) on Tue Jan 06 17:31:54 CST 2009 -->
+<META http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+<TITLE>
+IViewFilter (Carbide.c++ SDK API Reference)
+</TITLE>
+
+<META NAME="keywords" CONTENT="com.nokia.carbide.cpp.epoc.engine.preprocessor.IViewFilter interface">
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../../../../stylesheet.css" TITLE="Style">
+
+<SCRIPT type="text/javascript">
+function windowTitle()
+{
+ parent.document.title="IViewFilter (Carbide.c++ SDK API Reference)";
+}
+</SCRIPT>
+<NOSCRIPT>
+</NOSCRIPT>
+
+</HEAD>
+
+<BODY BGCOLOR="white" onload="windowTitle();">
+
+
+<!-- ========= START OF TOP NAVBAR ======= -->
+<A NAME="navbar_top"><!-- --></A>
+<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_top_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/IViewFilter.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../../../index-files/index-1.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+<b>Carbide.c++</b></EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../../../../com/nokia/carbide/cpp/epoc/engine/preprocessor/ITranslationUnitProvider.html" title="interface in com.nokia.carbide.cpp.epoc.engine.preprocessor"><B>PREV CLASS</B></A>
+ <A HREF="../../../../../../../com/nokia/carbide/cpp/epoc/engine/preprocessor/SharedNodesViewFilter.html" title="class in com.nokia.carbide.cpp.epoc.engine.preprocessor"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../../../../index.html?com/nokia/carbide/cpp/epoc/engine/preprocessor/IViewFilter.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="IViewFilter.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../../../../../../allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="../../../../../../../allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: NESTED | FIELD | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: FIELD | CONSTR | <A HREF="#method_detail">METHOD</A></FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_top"></A>
+<!-- ========= END OF TOP NAVBAR ========= -->
+
+<HR>
+<!-- ======== START OF CLASS DATA ======== -->
+<H2>
+<FONT SIZE="-1">
+com.nokia.carbide.cpp.epoc.engine.preprocessor</FONT>
+<BR>
+Interface IViewFilter</H2>
+<DL>
+<DT><B>All Known Implementing Classes:</B> <DD><A HREF="../../../../../../../com/nokia/carbide/cdt/builder/AcceptedBuildContextNodesViewFilter.html" title="class in com.nokia.carbide.cdt.builder">AcceptedBuildContextNodesViewFilter</A>, <A HREF="../../../../../../../com/nokia/carbide/cpp/epoc/engine/preprocessor/AcceptedNodesViewFilter.html" title="class in com.nokia.carbide.cpp.epoc.engine.preprocessor">AcceptedNodesViewFilter</A>, <A HREF="../../../../../../../com/nokia/carbide/cpp/epoc/engine/preprocessor/AllNodesViewFilter.html" title="class in com.nokia.carbide.cpp.epoc.engine.preprocessor">AllNodesViewFilter</A>, <A HREF="../../../../../../../com/nokia/carbide/cpp/epoc/engine/preprocessor/SharedNodesViewFilter.html" title="class in com.nokia.carbide.cpp.epoc.engine.preprocessor">SharedNodesViewFilter</A></DD>
+</DL>
+<HR>
+<DL>
+<DT><PRE>public interface <B>IViewFilter</B></DL>
+</PRE>
+
+<P>
+This interface, implemented by a client or by a standard implementation,
+ is used to determine how to interpret preprocessor conditionals and macros
+ when determining what content to expose from a preprocessor DOM.
+<P>
+
+<P>
+<DL>
+<DT><B>See Also:</B><DD><A HREF="../../../../../../../com/nokia/carbide/cpp/epoc/engine/model/IViewConfiguration.html" title="interface in com.nokia.carbide.cpp.epoc.engine.model"><CODE>IViewConfiguration</CODE></A>,
+<CODE>IPreprocessor</CODE></DL>
+<HR>
+
+<P>
+
+<!-- ========== METHOD SUMMARY =========== -->
+
+<A NAME="method_summary"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
+<B>Method Summary</B></FONT></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> boolean</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../../../../com/nokia/carbide/cpp/epoc/engine/preprocessor/IViewFilter.html#combineBranches()">combineBranches</A></B>()</CODE>
+
+<BR>
+ when #evaluteConditionals() returns true, then if true, then both true
+ and false branches of a test are included.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> boolean</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../../../../com/nokia/carbide/cpp/epoc/engine/preprocessor/IViewFilter.html#evaluateConditionalStatements()">evaluateConditionalStatements</A></B>()</CODE>
+
+<BR>
+ if true, use macro values to evaluate #if/etc nodes and include the
+ contents in the succeeding branch; else, conditionals are skipped
+ entirely</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> boolean</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../../../../com/nokia/carbide/cpp/epoc/engine/preprocessor/IViewFilter.html#evaluateUnconditionalStatements()">evaluateUnconditionalStatements</A></B>()</CODE>
+
+<BR>
+ if true, then nodes outside #if/etc are kept, else, they are skipped
+ entirely</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> boolean</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../../../../com/nokia/carbide/cpp/epoc/engine/preprocessor/IViewFilter.html#expandVariantMacros()">expandVariantMacros</A></B>()</CODE>
+
+<BR>
+ • variant macro: a macro whose value is determined to differ between
+ configurations, either by coming from a set of fixed macros or by being
+ defined inside #ifs in the translation unit
+
+ • if true, expand variant
+ macros when encountered in macro expressions and statements; else,
+ statements containing variant macros will be filtered out.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> boolean</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../../../../com/nokia/carbide/cpp/epoc/engine/preprocessor/IViewFilter.html#invertSuccess()">invertSuccess</A></B>()</CODE>
+
+<BR>
+ when #evaluteConditionals() returns true, then, if true, filter out
+ contents from successful tests and keep contents from failing tests</TD>
+</TR>
+</TABLE>
+
+<P>
+
+<!-- ============ METHOD DETAIL ========== -->
+
+<A NAME="method_detail"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
+<B>Method Detail</B></FONT></TH>
+</TR>
+</TABLE>
+
+<A NAME="evaluateUnconditionalStatements()"><!-- --></A><H3>
+evaluateUnconditionalStatements</H3>
+<PRE>
+boolean <B>evaluateUnconditionalStatements</B>()</PRE>
+<DL>
+<DD>if true, then nodes outside #if/etc are kept, else, they are skipped
+ entirely
+<P>
+<DD><DL>
+
+<DT><B>Returns:</B><DD></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="evaluateConditionalStatements()"><!-- --></A><H3>
+evaluateConditionalStatements</H3>
+<PRE>
+boolean <B>evaluateConditionalStatements</B>()</PRE>
+<DL>
+<DD>if true, use macro values to evaluate #if/etc nodes and include the
+ contents in the succeeding branch; else, conditionals are skipped
+ entirely
+<P>
+<DD><DL>
+
+<DT><B>Returns:</B><DD></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="invertSuccess()"><!-- --></A><H3>
+invertSuccess</H3>
+<PRE>
+boolean <B>invertSuccess</B>()</PRE>
+<DL>
+<DD>when #evaluteConditionals() returns true, then, if true, filter out
+ contents from successful tests and keep contents from failing tests
+<P>
+<DD><DL>
+
+<DT><B>Returns:</B><DD></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="combineBranches()"><!-- --></A><H3>
+combineBranches</H3>
+<PRE>
+boolean <B>combineBranches</B>()</PRE>
+<DL>
+<DD>when #evaluteConditionals() returns true, then if true, then both true
+ and false branches of a test are included.
+<P>
+<DD><DL>
+
+<DT><B>Returns:</B><DD></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="expandVariantMacros()"><!-- --></A><H3>
+expandVariantMacros</H3>
+<PRE>
+boolean <B>expandVariantMacros</B>()</PRE>
+<DL>
+<DD>• variant macro: a macro whose value is determined to differ between
+ configurations, either by coming from a set of fixed macros or by being
+ defined inside #ifs in the translation unit
+ <p>
+ • if true, expand variant
+ macros when encountered in macro expressions and statements; else,
+ statements containing variant macros will be filtered out. (Macros in #if
+ expressions are outside the scope of this query.)
+<P>
+<DD><DL>
+
+<DT><B>Returns:</B><DD></DL>
+</DD>
+</DL>
+<!-- ========= END OF CLASS DATA ========= -->
+<HR>
+
+
+<!-- ======= START OF BOTTOM NAVBAR ====== -->
+<A NAME="navbar_bottom"><!-- --></A>
+<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_bottom_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/IViewFilter.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../../../index-files/index-1.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+<b>Carbide.c++</b></EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../../../../com/nokia/carbide/cpp/epoc/engine/preprocessor/ITranslationUnitProvider.html" title="interface in com.nokia.carbide.cpp.epoc.engine.preprocessor"><B>PREV CLASS</B></A>
+ <A HREF="../../../../../../../com/nokia/carbide/cpp/epoc/engine/preprocessor/SharedNodesViewFilter.html" title="class in com.nokia.carbide.cpp.epoc.engine.preprocessor"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../../../../index.html?com/nokia/carbide/cpp/epoc/engine/preprocessor/IViewFilter.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="IViewFilter.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../../../../../../allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="../../../../../../../allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: NESTED | FIELD | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: FIELD | CONSTR | <A HREF="#method_detail">METHOD</A></FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_bottom"></A>
+<!-- ======== END OF BOTTOM NAVBAR ======= -->
+
+<HR>
+<div id="footer">Copyright © 2010 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+</BODY>
+</HTML>