mirror of
https://github.com/boostorg/wave.git
synced 2026-02-22 15:52:22 +00:00
130 lines
7.7 KiB
HTML
130 lines
7.7 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html>
|
|
<head>
|
|
<title>Quick Start</title>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
|
|
<link href="theme/style.css" rel="stylesheet" type="text/css">
|
|
</head>
|
|
|
|
<body text="#000000" background="theme/bkd.gif">
|
|
<table width="100%" border="0" cellspacing="2" background="theme/bkd2.gif">
|
|
<tr>
|
|
<td width="21"> <h1></h1></td>
|
|
<td width="885"> <font face="Verdana, Arial, Helvetica, sans-serif"><b><font size="6">Quick
|
|
Start </font></b></font></td>
|
|
<td width="96"><a href="http://spirit.sf.net"><img src="theme/wave.gif" width="93" height="68" align="right" border="0"></a></td>
|
|
</tr>
|
|
</table>
|
|
<br>
|
|
<table border="0">
|
|
<tr>
|
|
<td width="10"></td>
|
|
<td width="30"><a href="../index.html"><img src="theme/u_arr.gif" border="0"></a></td>
|
|
<td width="30"><a href="introduction.html"><img src="theme/l_arr.gif" width="20" height="19" border="0"></a></td>
|
|
<td width="30"><a href="class_reference_context.html"><img src="theme/r_arr.gif" border="0"></a></td>
|
|
</tr>
|
|
</table>
|
|
<p>The actual preprocessing itself is highly configurable, so obviously
|
|
you have to define a couple of parameters to control this process, such
|
|
as:</p>
|
|
<BLOCKQUOTE dir="ltr" style="MARGIN-RIGHT: 0px">
|
|
<P><STRONG><IMG id="IMG1" height="13" src="theme/bullet.gif" width="13"></STRONG> include
|
|
search pathes, which define, where to search for files to be included with
|
|
<tt>#include <...></tt> and <tt>#include "..."</tt> directives<br>
|
|
<STRONG><img src="theme/bullet.gif" width="13" height="13"> </STRONG>which
|
|
macros to predefine and which of the predefined macros to undefine<br>
|
|
<STRONG><img src="theme/bullet.gif" width="13" height="13"> </STRONG>several
|
|
other options as for instance to control, whether to enable several extensions
|
|
to the C++ Standard (as for instance variadics and placemarkers) or not.</P>
|
|
</BLOCKQUOTE>
|
|
<p>You can access all these processing parameters through the <tt>boost::wave::context</tt>
|
|
object. So you have to instantiate one object of this type to use the <tt>Wave</tt>
|
|
library. For more information about the context template class please refer
|
|
to the class reference <a href="class_reference_context.html">here</a>. To instantiate
|
|
the <tt>boost::wave::context</tt> object you have to supply at least two template parameters:
|
|
the iterator type of the underlying input stream to use and the type of the lexer iterator to be used as the token source for the preprocessing engine.</p>
|
|
<P dir="ltr">The main preprocessing iterators are not to be instantiated directly,
|
|
but should be generated through this context object too. The following code snippet is taken from the <a href="../samples/quick_start/quick_start.cpp">quick_start</a> sample, which shows a minimal usage scenario for <tt>Wave</tt>. </P>
|
|
<pre><span class="comment"> // The following preprocesses a given input file.
|
|
// Open the file and read it into a string variable</span>
|
|
<span class="keyword">std::ifstream</span> instream(<span class="string">"input.cpp"</span>);
|
|
<span class="keyword">std::string </span>input<span class="keyword">(
|
|
std::istreambuf_iterator<char></span>(instream.rdbuf());
|
|
<span class="keyword">std::istreambuf_iterator<char></span>());
|
|
|
|
<span class="comment">// The template boost::wave::cpplexer::lex_token<> is the
|
|
// token type to be used by the Wave library.
|
|
// This token type is one of the central types throughout
|
|
// the library, because it is a template parameter to some
|
|
// of the public classes and templates and it is returned
|
|
// from the iterators itself.
|
|
// The template boost::wave::cpplexer::lex_iterator<> is
|
|
// the lexer iterator to use as the token source for the
|
|
// preprocessing engine. In this case this is parametrized
|
|
// with the token type.</span>
|
|
<span class="keyword">typedef</span> <span class="identifier">boost::wave::cpplexer::lex_iterator</span><span class="special"><</span>
|
|
<span class="identifier">boost::wave::cpplexer::lex_token</span><span class="special"><> ></span>
|
|
<span class="identifier">lex_iterator_t</span><span class="special">;</span>
|
|
<span class="keyword">typedef</span> <span class="identifier">boost::wave::context</span><span class="special"><</span>
|
|
std::string::iterator<span class="special">,</span> lex_iterator_t<span class="special">></span>
|
|
<span class="identifier">context_t</span><span class="special">;</span>
|
|
|
|
<span class="comment">// The C++ preprocessor iterators shouldn't be constructed
|
|
// directly. These are to be generated through a
|
|
// boost::wave::context<> object. Additionally this
|
|
// boost::wave::context<> object is to be used to initialize
|
|
// and define different parameters of the actual preprocessing.
|
|
</span> context_t ctx(input.begin(), input.end(), <span class="string">"input.cpp"</span>);
|
|
|
|
<span class="comment"> // At this point you may want to set the parameters of the
|
|
// preprocessing as include pathes and/or predefined macros.
|
|
</span> ctx.add_include_path(<span class="literal">"..."</span>);
|
|
ctx.add_macro_definition(...);
|
|
|
|
<span class="comment"> // Get the preprocessor iterators and use them to generate
|
|
// the token sequence.
|
|
</span> context_t::iterator_t first = ctx.begin();
|
|
context_t::iterator_t last = ctx.end();
|
|
|
|
<span class="comment"> // The preprocessing of the input stream is done on the fly
|
|
// behind the scenes during the iteration over the
|
|
// context_t::iterator_t based stream. </span>
|
|
<span class="keyword">while</span> (first != last) {
|
|
<span class="keyword">std::cout</span> << (*first).get_value();
|
|
++first;
|
|
}
|
|
|
|
</pre>
|
|
<P dir="ltr">The constructor of the <tt>boost::wave::context</tt> object can
|
|
take a pair of arbitrary iterator types (at least <tt>input_iterator</tt> type
|
|
iterators) to the input stream, from where should be read the data to be preprocessed.
|
|
The third parameter supplies a filename, which is used subsequently inside the
|
|
preprocessed tokens returned from the preprocessing to indicate the token position
|
|
inside the underlying input stream. Note though, that this filename is used
|
|
only as long as no <tt>#include</tt> or <tt>#line</tt> directives are encountered,
|
|
which in turn will alter the current filename reported.</P>
|
|
<P dir="ltr">The iteration over the preprocessed tokens is relativly straight
|
|
forward. Just get the starting and the ending iterators from the context object
|
|
(maybe after initializing some include search paths) and you are done! The dereferencing
|
|
of the iterator will return the preprocessed tokens, which are generated on
|
|
the fly from the input stream. To get further information about the token type,
|
|
you may want to look <a href="class_reference_tokentype.html">here</a>.</P>
|
|
<table border="0">
|
|
<tr>
|
|
<td width="10"></td>
|
|
<td width="30"><a href="../index.html"><img src="theme/u_arr.gif" border="0"></a></td>
|
|
<td width="30"><a href="introduction.html"><img src="theme/l_arr.gif" width="20" height="19" border="0"></a></td>
|
|
<td width="30"><a href="class_reference_context.html"><img src="theme/r_arr.gif" border="0"></a></td>
|
|
</tr>
|
|
</table>
|
|
<hr size="1">
|
|
<p class="copyright">Copyright © 2003-2004 Hartmut Kaiser<br>
|
|
<br>
|
|
<font size="2">Use, modification and distribution is subject to the Boost Software
|
|
License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
|
</font> </p>
|
|
<span class="updated">Last updated:
|
|
<!-- #BeginDate format:fcAm1m -->Saturday, January 31, 2004 12:57<!-- #EndDate -->
|
|
</span></body>
|
|
</html>
|