Boost-Commit :

Date view	Thread view	Subject view	Author view

Subject: [Boost-commit] svn:boost r70142 - in sandbox/local/libs/local/doc/html: . boost_local
From: lorcaminiti_at_[hidden]
Date: 2011-03-18 17:41:54

Author: lcaminiti
Date: 2011-03-18 17:41:51 EDT (Fri, 18 Mar 2011)
New Revision: 70142
URL: http://svn.boost.org/trac/boost/changeset/70142

Log:
Updating docs.
Added:
   sandbox/local/libs/local/doc/html/BOOST_LOCAL_CONFIG_COMPIANT.html (contents, props changed)
   sandbox/local/libs/local/doc/html/BOOST_LOCAL_CONFIG_COMPLIANT.html (contents, props changed)
   sandbox/local/libs/local/doc/html/BOOST_LOCAL_TYPEOF.html (contents, props changed)
   sandbox/local/libs/local/doc/html/boost_local/AdvancedTopics.html (contents, props changed)
   sandbox/local/libs/local/doc/html/boost_local/Advanced_Topics.html (contents, props changed)
   sandbox/local/libs/local/doc/html/boost_local/Getting.html (contents, props changed)
   sandbox/local/libs/local/doc/html/boost_local/Getting_Started.html (contents, props changed)
   sandbox/local/libs/local/doc/html/boost_local/Release.html (contents, props changed)
   sandbox/local/libs/local/doc/html/boost_local/Release_Notes.html (contents, props changed)

Added: sandbox/local/libs/local/doc/html/BOOST_LOCAL_CONFIG_COMPIANT.html
==============================================================================
--- (empty file)
+++ sandbox/local/libs/local/doc/html/BOOST_LOCAL_CONFIG_COMPIANT.html 2011-03-18 17:41:51 EDT (Fri, 18 Mar 2011)
@@ -0,0 +1,49 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Macro BOOST_LOCAL_CONFIG_COMPIANT</title>
+<link rel="stylesheet" href="../../../../doc/src/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
+<link rel="home" href="index.html" title="Boost.Local 0.1.1">
+<link rel="up" href="reference.html#header.boost.local.config_hpp" title="Header <boost/local/config.hpp>">
+<link rel="prev" href="BOOST_LOCAL_BLOCK_END.html" title="Macro BOOST_LOCAL_BLOCK_END">
+<link rel="next" href="BOOST_LOCAL_CONFIG_FUNCTION_ARITY_MAX.html" title="Macro BOOST_LOCAL_CONFIG_FUNCTION_ARITY_MAX">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="BOOST_LOCAL_BLOCK_END.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="reference.html#header.boost.local.config_hpp"><img src="../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="BOOST_LOCAL_CONFIG_FUNCTION_ARITY_MAX.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+<div class="refentry">
+<a name="BOOST_LOCAL_CONFIG_COMPIANT"></a><div class="titlepage"></div>
+<div class="refnamediv">
+<h2>Macro BOOST_LOCAL_CONFIG_COMPIANT</h2>
+BOOST_LOCAL_CONFIG_COMPIANT
+</div>
+<h2 xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv-title">Synopsis</h2>
+<div xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv"><pre class="synopsis">// In header: <<a class="link" href="reference.html#header.boost.local.config_hpp" title="Header <boost/local/config.hpp>">boost/local/config.hpp</a>>
+
+BOOST_LOCAL_CONFIG_COMPIANT</pre></div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2009 -2011 Lorenzo Caminiti
+ Use, modification, and distribution is subject to the Boost Software License,
+ Version 1.0 (see accompanying file LICENSE_1_0.txt or a copy at http://www.boost.org/LICENSE_1_0.txt).
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="BOOST_LOCAL_BLOCK_END.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="reference.html#header.boost.local.config_hpp"><img src="../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="BOOST_LOCAL_CONFIG_FUNCTION_ARITY_MAX.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/local/libs/local/doc/html/BOOST_LOCAL_CONFIG_COMPLIANT.html
==============================================================================
--- (empty file)
+++ sandbox/local/libs/local/doc/html/BOOST_LOCAL_CONFIG_COMPLIANT.html 2011-03-18 17:41:51 EDT (Fri, 18 Mar 2011)
@@ -0,0 +1,57 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Macro BOOST_LOCAL_CONFIG_COMPLIANT</title>
+<link rel="stylesheet" href="../../../../doc/src/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
+<link rel="home" href="index.html" title="Boost.Local 0.1.1">
+<link rel="up" href="reference.html#header.boost.local.config_hpp" title="Header <boost/local/config.hpp>">
+<link rel="prev" href="BOOST_LOCAL_BLOCK_END.html" title="Macro BOOST_LOCAL_BLOCK_END">
+<link rel="next" href="BOOST_LOCAL_CONFIG_FUNCTION_ARITY_MAX.html" title="Macro BOOST_LOCAL_CONFIG_FUNCTION_ARITY_MAX">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="BOOST_LOCAL_BLOCK_END.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="reference.html#header.boost.local.config_hpp"><img src="../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="BOOST_LOCAL_CONFIG_FUNCTION_ARITY_MAX.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+<div class="refentry">
+<a name="BOOST_LOCAL_CONFIG_COMPLIANT"></a><div class="titlepage"></div>
+<div class="refnamediv">
+<h2>Macro BOOST_LOCAL_CONFIG_COMPLIANT</h2>
+BOOST_LOCAL_CONFIG_COMPLIANT — Force to use ISO C++ standard features only. 
+</div>
+<h2 xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv-title">Synopsis</h2>
+<div xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv"><pre class="synopsis">// In header: <<a class="link" href="reference.html#header.boost.local.config_hpp" title="Header <boost/local/config.hpp>">boost/local/config.hpp</a>>
+
+BOOST_LOCAL_CONFIG_COMPLIANT</pre></div>
+<div class="refsect1">
+<a name="id911316"></a><h2>Description</h2>
+If programmers leave this configuration macro undefined, its default value is to be left not defined.
+If this macro is defined, variadic macros and empty macro parameters are not used by this library. Using variadic macros and empty macro parameters allows this library to provide the variadic macro and empty macro syntaxes which some programmers might find more readable than the sequencing macro syntax (see <code class="computeroutput"><a class="link" href="BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>, <code class="computeroutput"><a class="link" href="BOOST_LOCAL_BLOCK.html" title="Macro BOOST_LOCAL_BLOCK">BOOST_LOCAL_BLOCK</a></code>, and <code class="computeroutput"><a class="link" href="BOOST_LOCAL_EXIT.html" title="Macro BOOST_LOCAL_EXIT">BOOST_LOCAL_EXIT</a></code>). If this configuration macro is defined then only the sequencing macro syntax is allowed (regardless of whether the compiler supports variadic and e
mpty macros or not).
+Warning: The variadic and empty macro syntaxes are not supported by all C++ compilers so they should be used with care to avoid portability issues (and this configuration macro can be defined to disable them).
+Variadic macros, are supported by most recent compilers (like MSVC and GCC) and they were first introduced by the C99 standard but they are not part of the official ISO C++ standard. Empty macro parameters are also supported by the C99 standards but they are not supported by all modern compilers (for example, they are not supported by MSVC).
+See: <a class="link" href="boost_local/Tutorial.html" title="Tutorial">Tutorial</a> section, <a class="link" href="boost_local/Getting.html" title="Getting Started">Getting Started</a> section. 
+</div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2009 -2011 Lorenzo Caminiti
+ Use, modification, and distribution is subject to the Boost Software License,
+ Version 1.0 (see accompanying file LICENSE_1_0.txt or a copy at http://www.boost.org/LICENSE_1_0.txt).
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="BOOST_LOCAL_BLOCK_END.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="reference.html#header.boost.local.config_hpp"><img src="../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="BOOST_LOCAL_CONFIG_FUNCTION_ARITY_MAX.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/local/libs/local/doc/html/BOOST_LOCAL_TYPEOF.html
==============================================================================
--- (empty file)
+++ sandbox/local/libs/local/doc/html/BOOST_LOCAL_TYPEOF.html 2011-03-18 17:41:51 EDT (Fri, 18 Mar 2011)
@@ -0,0 +1,75 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Macro BOOST_LOCAL_TYPEOF</title>
+<link rel="stylesheet" href="../../../../doc/src/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
+<link rel="home" href="index.html" title="Boost.Local 0.1.1">
+<link rel="up" href="reference.html#header.boost.local.typeof_hpp" title="Header <boost/local/typeof.hpp>">
+<link rel="prev" href="BOOST_LOCAL_FUNCTION_NAME.html" title="Macro BOOST_LOCAL_FUNCTION_NAME">
+<link rel="next" href="BOOST_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="BOOST_LOCAL_FUNCTION_NAME.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="reference.html#header.boost.local.typeof_hpp"><img src="../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="BOOST_IDENTITY_TYPE.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+<div class="refentry">
+<a name="BOOST_LOCAL_TYPEOF"></a><div class="titlepage"></div>
+<div class="refnamediv">
+<h2>Macro BOOST_LOCAL_TYPEOF</h2>
+BOOST_LOCAL_TYPEOF — This macro expands to the fully qualified type of a variable bound to to local functions, local blocks, and local exits. 
+</div>
+<h2 xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv-title">Synopsis</h2>
+<div xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv"><pre class="synopsis">// In header: <<a class="link" href="reference.html#header.boost.local.typeof_hpp" title="Header <boost/local/typeof.hpp>">boost/local/typeof.hpp</a>>
+
+BOOST_LOCAL_TYPEOF(bound_variable_name)</pre></div>
+<div class="refsect1">
+<a name="id915057"></a><h2>Description</h2>
+The type is fully qualified in that it contains the extra constant and reference qualifiers when they are specified for binding by constant and by reference. For example, if a variable named <code class="computeroutput">x</code> of type <code class="computeroutput">T</code> is: 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">Bound by value using <code class="computeroutput">bind x</code> then <code class="computeroutput">BOOST_LOCAL_TYPEOF(x)</code> is <code class="computeroutput">T</code>. </li>
+<li class="listitem">Bound by constant value using <code class="computeroutput">const bind x</code> then <code class="computeroutput">BOOST_LOCAL_TYPEOF(x)</code> is <code class="computeroutput">const T</code>. </li>
+<li class="listitem">Bound by reference using <code class="computeroutput">bind& x</code> then <code class="computeroutput">BOOST_LOCAL_TYPEOF(x)</code> is <code class="computeroutput">T&</code>. </li>
+<li class="listitem">Bound by constant reference using <code class="computeroutput">const bind& x</code> then <code class="computeroutput">BOOST_LOCAL_TYPEOF(x)</code> is <code class="computeroutput">const T&</code>.</li>
+</ul></div>
+
+Within local functions, local blocks, and local exits, this macro can be used to deduce the bound variable types to declare local variables, check concepts (using Boost.ConceptCheck), etc (see <a class="link" href="boost_local/Advanced.html" title="Advanced Topics">Advanced Topics</a> section).
+Parameters: 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<tbody><tr>
+<td><code class="computeroutput">bound_variable_name</code></td>
+<td>The bound variable name for which the type is being deduced by this macro. </td>
+</tr></tbody>
+</table></div>
+
+
+See: <code class="computeroutput"><a class="link" href="BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>, <code class="computeroutput"><a class="link" href="BOOST_LOCAL_BLOCK.html" title="Macro BOOST_LOCAL_BLOCK">BOOST_LOCAL_BLOCK</a></code>, <code class="computeroutput"><a class="link" href="BOOST_LOCAL_EXIT.html" title="Macro BOOST_LOCAL_EXIT">BOOST_LOCAL_EXIT</a></code>, <a class="link" href="boost_local/Advanced.html" title="Advanced Topics">Advanced Topics</a> section. 
+</div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2009 -2011 Lorenzo Caminiti
+ Use, modification, and distribution is subject to the Boost Software License,
+ Version 1.0 (see accompanying file LICENSE_1_0.txt or a copy at http://www.boost.org/LICENSE_1_0.txt).
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="BOOST_LOCAL_FUNCTION_NAME.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="reference.html#header.boost.local.typeof_hpp"><img src="../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="BOOST_IDENTITY_TYPE.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/local/libs/local/doc/html/boost_local/AdvancedTopics.html
==============================================================================
--- (empty file)
+++ sandbox/local/libs/local/doc/html/boost_local/AdvancedTopics.html 2011-03-18 17:41:51 EDT (Fri, 18 Mar 2011)
@@ -0,0 +1,1972 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Advanced Topics</title>
+<link rel="stylesheet" href="../../../../../doc/src/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
+<link rel="home" href="../index.html" title="Boost.Local 0.1.1">
+<link rel="up" href="../index.html" title="Boost.Local 0.1.1">
+<link rel="prev" href="Tutorial.html" title="Tutorial">
+<link rel="next" href="../reference.html" title="Reference">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="Tutorial.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="../reference.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="boost_local.AdvancedTopics"></a><a class="link" href="AdvancedTopics.html" title="Advanced Topics">Advanced Topics</a>
+</h2></div></div></div>
+<div class="toc"><dl>
+<dt><a href="AdvancedTopics.html#boost_local.AdvancedTopics.commas_and_symbols_in_macro_parameters">Commas
+ and Symbols in Macro Parameters</a></dt>
+<dt><a href="AdvancedTopics.html#boost_local.AdvancedTopics.deducing_bound_types__concepts__etc_">Deducing
+ Bound Types (concepts, etc)</a></dt>
+<dt><a href="AdvancedTopics.html#boost_local.AdvancedTopics.passing_local_functions">Passing
+ Local Functions</a></dt>
+<dt><a href="AdvancedTopics.html#boost_local.AdvancedTopics.exception_specifications">Exception
+ Specifications</a></dt>
+<dt><a href="AdvancedTopics.html#boost_local.AdvancedTopics.storage_classifiers___auto__and__register__">Storage
+ Classifiers (<code class="computeroutput">auto</code> and <code class="computeroutput">register</code>)</a></dt>
+<dt><a href="AdvancedTopics.html#boost_local.AdvancedTopics.recursive_local_functions">Recursive
+ Local Functions</a></dt>
+<dt><a href="AdvancedTopics.html#boost_local.AdvancedTopics.nested_declarations">Nested
+ Declarations</a></dt>
+<dt><a href="AdvancedTopics.html#boost_local.AdvancedTopics.limitations__overloading__operators__etc_">Limitations
+ (overloading, operators, etc)</a></dt>
+</dl></div>
+
+ This section illustrates advanced usage of this library. At the end of this
+ section there is also a list of knwon limitations of this library.
+ 
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.AdvancedTopics.commas_and_symbols_in_macro_parameters"></a><a class="link" href="AdvancedTopics.html#boost_local.AdvancedTopics.commas_and_symbols_in_macro_parameters" title="Commas and Symbols in Macro Parameters">Commas
+ and Symbols in Macro Parameters</a>
+</h3></div></div></div>
+
+ The C++ preprocessor does not allow commas <code class="computeroutput">,</code>
+ within macro parameters unless they are wrapped by the round parenthesis
+ <code class="computeroutput">()</code>. Therefore, using commas
+ within the local function parameters and bindings will generate (cryptic)
+ preprocessor errors unless they are wrapped within extra round parenthesis
+ <code class="computeroutput">()</code> as explained here.
+ 
+<div class="note"><table border="0" summary="Note">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../../../../../doc/src/images/note.png"></td>
+<th align="left">Note</th>
+</tr>
+<tr><td align="left" valign="top">
+ Macro parameters with commas which are
+ already wrapped by round parenthesis <code class="computeroutput">()</code>
+ are fine (function calls, etc). However, macro parameters with commas that
+ are not wrapped by round parenthesis need to be wrapped by an extra set
+ of round parenthesis <code class="computeroutput">()</code> as
+ described here. Also macro parameters with commas wrapped by angular parenthesis
+ <code class="computeroutput"><></code> (templates, etc)
+ or square parenthesis <code class="computeroutput">[]</code> (multidimensional
+ array access, etc) need to be wrapped by the extra round parenthesis <code class="computeroutput">()</code> as explained here (this is because the
+ preprocessor only recognizes the round parenthesis and it does not recognize
+ angular, square, or any other type of parenthesis).
+ </td></tr>
+</table></div>
+
+ In addition, local function parameter types cannot start with non-alphanumeric
+ symbols (alphanumeric symbols are <code class="computeroutput">A-Z</code>, <code class="computeroutput">a-z</code>,
+ and <code class="computeroutput">0-9</code>). [<a name="id881888" href="#ftn.id881888" class="footnote">15</a>] The library will generate (cryptic) preprocessor errors if a
+ parameter type starts with a non-alphanumeric symbol.
+ 
+
+ Let's consider the following example:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Variadic Macro Syntax (C99 and later compilers)
+ 
+ </th>
+<th>
+ 
+ Sequencing Macro Syntax (all C++ compilers)
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">... <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>(
+ const std::map<std::string, size_t>& m, // (1) Error.
+ ::sign_t sign, // (2) Error.
+ const size_t& factor, default
+ key_size<std::string, size_t>::value, // (3) Error.
+ const std::string& separator, default cat(":", " "), // (4) OK.
+) ...
+</pre>
+
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">... <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>(
+ (const std::map<std::string, size_t>& m) // (1) Error.
+ (::sign_t sign) // (2) Error.
+ (const size_t& factor)(default
+ key_size<std::string, size_t>::value) // (3) Error.
+ (const std::string& separator)(default cat(":", " ")) // (4) OK.
+) ...
+</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+
+ (1) The parameter type <code class="computeroutput">const
+ std::map<std::string, size_t>&</code> contains a comma <code class="computeroutput">,</code>
+ after the first template parameter <code class="computeroutput">std::string</code>.
+ This comma is not wrapped by any round parenthesis <code class="computeroutput">()</code>
+ (the outer parenthesis <code class="computeroutput">()</code> that
+ make the sequencing macro syntax do not count) thus it will cause a preprocessor
+ error. The macro <code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">BOOST_IDENTITY_TYPE</a>(</code>parenthesized-type<code class="computeroutput">)</code> can be used to wrap a type within extra
+ parenthesis <code class="computeroutput">()</code> so to overcome
+ this issue:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Variadic Macro Syntax (C99 and later compilers)
+ 
+ </th>
+<th>
+ 
+ Sequencing Macro Syntax (all C++ compilers)
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">... <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>(
+ <code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">BOOST_IDENTITY_TYPE</a></code>((const std::map<std::string, size_t>&)) m, // OK.
+ ...
+) ...
+</pre>
+
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">... <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>(
+ (<code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">BOOST_IDENTITY_TYPE</a></code>((const std::map<std::string, size_t>&)) m) // OK.
+ ...
+) ...
+</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+
+ This macro expands to an expression that evaluates (at compile-time) exactly
+ to the specified type. Note that a total of two set of parenthesis <code class="computeroutput">()</code> are added:
+ 
+<div class="orderedlist"><ol class="orderedlist" type="1">
+<li class="listitem">
+ Parenthesis to invoke the <code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">BOOST_IDENTITY_TYPE</a></code>
+ macro.
+ </li>
+<li class="listitem">
+ Parenthesis to wrap the type expression (and therefore any commas <code class="computeroutput">,</code> that it contains) passed as parameter
+ to the <code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">BOOST_IDENTITY_TYPE</a></code>
+ macro. [<a name="id883246" href="#ftn.id883246" class="footnote">16</a>]
+ </li>
+</ol></div>
+
+ (2) The parameter type <code class="computeroutput">::sign_t</code> start with the non-alphanumeric
+ symbols <code class="computeroutput">::</code> thus it will generate
+ preprocessor errors if used as a local function parameter type. The macros
+ <code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">BOOST_IDENTITY_TYPE</a></code>
+ can also be used to overcome this issue:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Variadic Macro Syntax (C99 and later compilers)
+ 
+ </th>
+<th>
+ 
+ Sequencing Macro Syntax (all C++ compilers)
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">... <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>(
+ ...
+ <code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">BOOST_IDENTITY_TYPE</a></code>((::sign_t)) sign, // OK.
+ ...
+) ...
+</pre>
+
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">... <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>(
+ ...
+ (<code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">BOOST_IDENTITY_TYPE</a></code>((::sign_t)) sign) // OK.
+ ...
+) ...
+</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+
+ Often, there might be better ways to overcome this limitation that lead to
+ code which is more readable than the one using the <code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">BOOST_IDENTITY_TYPE</a></code>
+ macro. For example, in this case the symbols <code class="computeroutput">::</code>
+ could have been simply dropped to obtain the following valid and more readable
+ code:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Variadic Macro Syntax (C99 and later compilers)
+ 
+ </th>
+<th>
+ 
+ Sequencing Macro Syntax (all C++ compilers)
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">... <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>(
+ ...
+ sign_t sign, // OK.
+ ...
+) ...
+</pre>
+
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">... <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>(
+ ...
+ (sign_t sign) // OK.
+ ...
+) ...
+</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+
+ (3) The default parameter value <code class="computeroutput">key_size<std::string, size_t>::value</code>
+ contains a comma <code class="computeroutput">,</code> after the
+ first template parameter <code class="computeroutput">std::string</code>.
+ Again, this comma is not wrapped by any parenthesis <code class="computeroutput">()</code>
+ so it will cause a preprocessor error. Because this is a value expression
+ (and not a type expression), it can be simply wrapped within an extra set
+ of round parenthesis <code class="computeroutput">()</code>:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Variadic Macro Syntax (C99 and later compilers)
+ 
+ </th>
+<th>
+ 
+ Sequencing Macro Syntax (all C++ compilers)
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">... <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>(
+ ...
+ const size_t& factor, default
+ (key_size<std::string, size_t>::value), // OK.
+ ...
+) ...
+</pre>
+
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">... <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>(
+ ...
+ (const size_t& factor)(default
+ (key_size<std::string, size_t>::value)) // OK.
+ ...
+) ...
+</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<div class="note"><table border="0" summary="Note">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../../../../../doc/src/images/note.png"></td>
+<th align="left">Note</th>
+</tr>
+<tr><td align="left" valign="top">
+ Alternatively, the macro <code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_VALUE.html" title="Macro BOOST_IDENTITY_VALUE">BOOST_IDENTITY_VALUE</a>(</code>parenthesized-value<code class="computeroutput">)</code> could have been used. This macro expands
+ to an expression that evaluates (at run-time) exactly to the specified
+ value -- but it adds overhead compared with simply using the extra parenthesis
+ <code class="computeroutput">()</code>. Note that, similarly to
+ <code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">BOOST_IDENTITY_TYPE</a></code>,
+ the <code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_VALUE.html" title="Macro BOOST_IDENTITY_VALUE">BOOST_IDENTITY_VALUE</a></code>
+ macro also requires two sets of extra parenthesis one set for invoking
+ the macro and another set to wrap the value expression passed as the macro
+ parameter.
+ </td></tr>
+</table></div>
+
+ (4) The default parameter value <code class="computeroutput">cat(":", " ")</code> is instead fine because it contains a comma
+ <code class="computeroutput">,</code> which is already wrapped by
+ the parenthesis <code class="computeroutput">()</code> of the function
+ call <code class="computeroutput">cat(...)</code>.
+ 
+<div class="important"><table border="0" summary="Important">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Important]" src="../../../../../doc/src/images/important.png"></td>
+<th align="left">Important</th>
+</tr>
+<tr><td align="left" valign="top">
+ The <code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">BOOST_IDENTITY_TYPE</a></code>
+ macro must be prefixed by the <code class="computeroutput">typename</code>
+ keyword when used within templates.
+ </td></tr>
+</table></div>
+
+ Consider the following complete example: [<a name="id884550" href="#ftn.id884550" class="footnote">17</a>]
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Variadic Macro Syntax (C99 and later compilers)
+ 
+ </th>
+<th>
+ 
+ Sequencing Macro Syntax (all C++ compilers)
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">#include <boost/local/function.hpp>
+#include <boost/utility/identity.hpp>
+#include <map>
+#include <string>
+#include <iostream>
+
+template<typename K, typename T> struct key_size { static const size_t value; };
+template<typename K, typename T> const size_t key_size<K, T>::value = sizeof(K);
+
+std::string cat(const std::string& a, const std::string& b) { return a + b; }
+
+typedef int const& sign_t;
+
+int main() {
+ void BOOST_LOCAL_FUNCTION_PARAMS(
+ // Identity macros handle commas.
+ BOOST_IDENTITY_TYPE((const std::map<std::string, size_t>))& m,
+ // Also, identity macros handle leading symbols.
+ BOOST_IDENTITY_TYPE((::sign_t)) sign, default -1,
+ const size_t& factor, default // Or use `BOOST_IDENTITY_VALE`.
+ (key_size<std::string, size_t>::value),
+ const std::string& separator, default cat(":", " ")) {
+ for (std::map<std::string, size_t>::const_iterator i = m.begin();
+ i != m.end(); ++i) {
+ std::cout << i->first << separator <<
+ sign * int(i->second) * int(factor) << std::endl;
+ }
+ } BOOST_LOCAL_FUNCTION_NAME(print)
+
+ std::map<std::string, size_t> sizes;
+ sizes["a"] = 1; sizes["ab"] = 2; sizes["abc"] = 3;
+ print(sizes);
+
+ return 0;
+}
+</pre>
+
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">#include <boost/local/function.hpp>
+#include <boost/utility/identity.hpp>
+#include <map>
+#include <string>
+#include <iostream>
+
+template<typename K, typename T> struct key_size { static const size_t value; };
+template<typename K, typename T> const size_t key_size<K, T>::value = sizeof(K);
+
+std::string cat(const std::string& a, const std::string& b) { return a + b; }
+
+typedef int const& sign_t;
+
+int main() {
+ void BOOST_LOCAL_FUNCTION_PARAMS(
+ // Identity macros handle commas.
+ (BOOST_IDENTITY_TYPE((const std::map<std::string, size_t>))& m)
+ // Also, identity macros handle leading symbols.
+ (BOOST_IDENTITY_TYPE((::sign_t)) sign)(default -1)
+ (const size_t& factor)(default // Or use `BOOST_IDENTITY_VALUE`.
+ (key_size<std::string, size_t>::value))
+ (const std::string& separator)(default cat(":", " ")) ) {
+ for (std::map<std::string, size_t>::const_iterator i = m.begin();
+ i != m.end(); ++i) {
+ std::cout << i->first << separator <<
+ sign * int(i->second) * int(factor) << std::endl;
+ }
+ } BOOST_LOCAL_FUNCTION_NAME(print)
+
+ std::map<std::string, size_t> sizes;
+ sizes["a"] = 1; sizes["ab"] = 2; sizes["abc"] = 3;
+ print(sizes);
+
+ return 0;
+}
+</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.AdvancedTopics.deducing_bound_types__concepts__etc_"></a><a class="link" href="AdvancedTopics.html#boost_local.AdvancedTopics.deducing_bound_types__concepts__etc_" title="Deducing Bound Types (concepts, etc)">Deducing
+ Bound Types (concepts, etc)</a>
+</h3></div></div></div>
+
+ While the ISO C++ standard does not allow for member functions of local classes
+ to have template parameters, this library allows to call template functions
+ from within a local function, a local block, or a local exit passing bound
+ variables without explicitly specifying their types. This essentially allows
+ local functions, local blocks, and local exits to be polymorphic
+ in the type of the bound variables (like a template is polymorphic in the
+ type of its template parameters).
+ 
+
+ Furthermore, this library allow to access the type of the bound variables
+ from within the local function, local block, or local exit using the following
+ macro:
+ 
+<pre class="programlisting">#include <boost/local/typeof.hpp>
+
+... // Within a local function, local block, or local exit.
+<code class="computeroutput"><a class="link" href="../BOOST_LOCAL_TYPEOF.html" title="Macro BOOST_LOCAL_TYPEOF">BOOST_LOCAL_TYPEOF</a></code>(bound-variable) ...
+...
+</pre>
+
+ This macro expands to a type expression that evaluates (at compile-time)
+ to the fully qualified type of the specified bound variable.
+ 
+<div class="note"><table border="0" summary="Note">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../../../../../doc/src/images/note.png"></td>
+<th align="left">Note</th>
+</tr>
+<tr><td align="left" valign="top">
+ This type expression is fully qualified in the sense that it will be constant
+ if the variable is bound by constant and it will also be a reference is
+ the variable is bound by reference (if needed, programmers can strip away
+ the <code class="computeroutput">const</code> and <code class="computeroutput">&</code> qualifiers using <code class="computeroutput">boost::remove_const</code>
+ and <code class="computeroutput">boost::remove_reference</code>, or similar template
+ metafunctions).
+ </td></tr>
+</table></div>
+
+ The deduced bound type can be used within the body to declare a local variable,
+ to check concepts, etc. For example:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Variadic Macro Syntax (C99 and later compilers)
+ 
+ </th>
+<th>
+ 
+ Sequencing Macro Syntax (all C++ compilers)
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">#include <boost/local/function.hpp>
+#include <boost/local/block.hpp>
+#include <boost/local/exit.hpp>
+#include <boost/local/typeof.hpp> // Typeof header.
+#include <boost/type_traits.hpp>
+#include <boost/concept_check.hpp>
+#include <algorithm>
+#include <cassert>
+
+double total(const double& x, const double& y, const double& z) {
+ double sum = double();
+ int factor = 10;
+
+ double BOOST_LOCAL_FUNCTION_PARAMS(double num, const bind factor,
+ bind& sum) {
+ // Typeof for variable declaration.
+ BOOST_LOCAL_TYPEOF(factor) f = factor;
+ return sum += f * num;
+ } BOOST_LOCAL_FUNCTION_NAME(add)
+ add(x);
+
+ size_t size = 2;
+ double* nums = new double[size];
+ BOOST_LOCAL_EXIT(const bind& size, bind nums) {
+ // Typeof is qualified with eventual bind's `const` and `&`.
+ boost::remove_const<boost::remove_reference<
+ BOOST_LOCAL_TYPEOF(size)>::type>::type s;
+ s = size;
+ if (s && nums) delete[] nums;
+ } BOOST_LOCAL_EXIT_END
+
+ nums[0] = y; nums[1] = z;
+ std::for_each(nums, nums + size, add);
+
+ BOOST_LOCAL_BLOCK(const bind &sum, const bind& factor,
+ const bind& x, const bind& y, const bind& z) {
+ // Typeof for concept checking.
+ BOOST_CONCEPT_ASSERT((boost::EqualityComparable<
+ BOOST_LOCAL_TYPEOF(sum)>));
+ assert(sum == factor * (x + y + z));
+ } BOOST_LOCAL_BLOCK_END
+
+ return sum;
+}
+
+int main() {
+ total(100.0, 90.5, 7.0);
+ return 0;
+}
+</pre>
+
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">#include <boost/local/function.hpp>
+#include <boost/local/block.hpp>
+#include <boost/local/exit.hpp>
+#include <boost/local/typeof.hpp> // Typeof header.
+#include <boost/type_traits.hpp>
+#include <boost/concept_check.hpp>
+#include <algorithm>
+#include <cassert>
+
+double total(const double& x, const double& y, const double& z) {
+ double sum = double();
+ int factor = 10;
+
+ double BOOST_LOCAL_FUNCTION_PARAMS( (double num) (const bind factor)
+ (bind& sum) ) {
+ // Typeof for variable declaration.
+ BOOST_LOCAL_TYPEOF(factor) f = factor;
+ return sum += f * num;
+ } BOOST_LOCAL_FUNCTION_NAME(add)
+ add(x);
+
+ size_t size = 2;
+ double* nums = new double[size];
+ BOOST_LOCAL_EXIT( (const bind& size) (bind nums) ) {
+ // Typeof is qualified with eventual bind's `const` and `&`.
+ boost::remove_const<boost::remove_reference<
+ BOOST_LOCAL_TYPEOF(size)>::type>::type s;
+ s = size;
+ if (s && nums) delete[] nums;
+ } BOOST_LOCAL_EXIT_END
+
+ nums[0] = y; nums[1] = z;
+ std::for_each(nums, nums + size, add);
+
+ BOOST_LOCAL_BLOCK( (const bind &sum) (const bind& factor)
+ (const bind& x) (const bind& y) (const bind& z) ) {
+ // Typeof for concept checking.
+ BOOST_CONCEPT_ASSERT((boost::EqualityComparable<
+ BOOST_LOCAL_TYPEOF(sum)>));
+ assert(sum == factor * (x + y + z));
+ } BOOST_LOCAL_BLOCK_END
+
+ return sum;
+}
+
+int main() {
+ total(100.0, 90.5, 7.0);
+ return 0;
+}
+</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+
+ Within templates, <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_TYPEOF.html" title="Macro BOOST_LOCAL_TYPEOF">BOOST_LOCAL_TYPEOF</a></code>
+ does not require to be prefixed by the <code class="computeroutput">typename</code>
+ keyword but eventual type manipulations need the <code class="computeroutput">typename</code>
+ prefix as usual:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Variadic Macro Syntax (C99 and later compilers)
+ 
+ </th>
+<th>
+ 
+ Sequencing Macro Syntax (all C++ compilers)
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">#include <boost/local/function.hpp>
+#include <boost/local/block.hpp>
+#include <boost/local/exit.hpp>
+#include <boost/local/typeof.hpp> // Typeof header.
+#include <boost/type_traits.hpp>
+#include <boost/concept_check.hpp>
+#include <algorithm>
+#include <cassert>
+
+template<typename T>
+T total(const T& x, const T& y, const T& z) {
+ T sum = T();
+ int factor = 10;
+
+ T BOOST_LOCAL_FUNCTION_PARAMS_TPL(T num, const bind factor,
+ bind& sum) {
+ // Typeof for variable declaratin.
+ BOOST_LOCAL_TYPEOF(factor) f = factor;
+ return sum += f * num;
+ } BOOST_LOCAL_FUNCTION_NAME(add)
+ add(x);
+
+ size_t size = 2;
+ T* nums = new T[size];
+ BOOST_LOCAL_EXIT_TPL(const bind& size, bind nums) {
+ // Typeof is qualified with eventual bind's `const` and `&`.
+ boost::remove_const<boost::remove_reference<
+ BOOST_LOCAL_TYPEOF(size)>::type>::type s;
+ s = size;
+ if (s && nums) delete[] nums;
+ } BOOST_LOCAL_EXIT_END
+
+ nums[0] = y; nums[1] = z;
+ std::for_each(nums, nums + size, add);
+
+ BOOST_LOCAL_BLOCK_TPL(const bind &sum, const bind& factor,
+ const bind& x, const bind& y, const bind& z) {
+ // Tyepof for concept checking.
+ BOOST_CONCEPT_ASSERT((boost::EqualityComparable<
+ BOOST_LOCAL_TYPEOF(sum)>));
+ assert(sum == factor * (x + y + z));
+ } BOOST_LOCAL_BLOCK_END
+
+ return sum;
+}
+
+int main() {
+ total(100.0, 90.5, 7.0);
+ return 0;
+}
+</pre>
+
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">#include <boost/local/function.hpp>
+#include <boost/local/block.hpp>
+#include <boost/local/exit.hpp>
+#include <boost/local/typeof.hpp> // Typeof header.
+#include <boost/type_traits.hpp>
+#include <boost/concept_check.hpp>
+#include <algorithm>
+#include <cassert>
+
+template<typename T>
+T total(const T& x, const T& y, const T& z) {
+ T sum = T();
+ int factor = 10;
+
+ T BOOST_LOCAL_FUNCTION_PARAMS_TPL( (T num) (const bind factor)
+ (bind& sum) ) {
+ // Typeof for variable declaration.
+ BOOST_LOCAL_TYPEOF(factor) f = factor;
+ return sum += f * num;
+ } BOOST_LOCAL_FUNCTION_NAME(add)
+ add(x);
+
+ size_t size = 2;
+ T* nums = new T[size];
+ BOOST_LOCAL_EXIT_TPL( (const bind& size) (bind nums) ) {
+ // Typeof is qualified with eventual bind's `const` and `&`.
+ boost::remove_const<boost::remove_reference<
+ BOOST_LOCAL_TYPEOF(size)>::type>::type s;
+ s = size;
+ if (s && nums) delete[] nums;
+ } BOOST_LOCAL_EXIT_END
+
+ nums[0] = y; nums[1] = z;
+ std::for_each(nums, nums + size, add);
+
+ BOOST_LOCAL_BLOCK_TPL( (const bind &sum) (const bind& factor)
+ (const bind& x) (const bind& y) (const bind& z) ) {
+ // Typeof for concept checking.
+ BOOST_CONCEPT_ASSERT((boost::EqualityComparable<
+ BOOST_LOCAL_TYPEOF(sum)>));
+ assert(sum == factor * (x + y + z));
+ } BOOST_LOCAL_BLOCK_END
+
+ return sum;
+}
+
+int main() {
+ total(100.0, 90.5, 7.0);
+ return 0;
+}
+</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.AdvancedTopics.passing_local_functions"></a><a class="link" href="AdvancedTopics.html#boost_local.AdvancedTopics.passing_local_functions" title="Passing Local Functions">Passing
+ Local Functions</a>
+</h3></div></div></div>
+
+ Local functions can be used as functors. For example, it is possible to assign
+ a local function to a functor parameter (using <code class="computeroutput">boost::function</code>,
+ etc) in order to pass the local function to another function. However, it
+ is in general recommended to use the <code class="computeroutput">boost::local::<a class="link" href="../boost/local/function.html" title="Struct template function">function</a></code>
+ functor because it supports default parameters.
+ 
+<div class="important"><table border="0" summary="Important">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Important]" src="../../../../../doc/src/images/important.png"></td>
+<th align="left">Important</th>
+</tr>
+<tr><td align="left" valign="top">
+ When assigning a local function to a functor, programmers need to make
+ sure that the local function survives the scope of
+ the functor otherwise the functor will be invalid and its use
+ will generate a run-time error (as usual with C++ functors).
+ </td></tr>
+</table></div>
+
+ The <code class="computeroutput">boost::local::<a class="link" href="../boost/local/function.html" title="Struct template function">function</a></code> template takes two
+ parameters (see the Reference section):
+ 
+<pre class="programlisting">template< typename F, size_t defaults = 0 > class <code class="computeroutput"><a class="link" href="../boost/local/function.html" title="Struct template function">function</a></code>;
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>F</dt>
+<dd>
+
+ The template parameter <code class="computeroutput">F</code>
+ is a function type specifying the function signature using the same
+ syntax as Boost.Function's
+ preferred syntax. For example:
+
+<pre class="programlisting"><code class="computeroutput"><a class="link" href="../boost/local/function.html" title="Struct template function">function</a></code>< int() > // Returns `int` and takes no parameter.
+<code class="computeroutput"><a class="link" href="../boost/local/function.html" title="Struct template function">function</a></code>< int(double, char) > // Returns `int`and takes two parameters: a `double` followed by a `char`.
+</pre>
+
+ 
+</dd>
+<dt>defaults</dt>
+<dd>
+
+ The template parameter <code class="computeroutput">defaults</code>
+ is a non-negative integer number specifying the number of defaults
+ parameters (counting from the last parameter as usual): <code class="computeroutput">0</code> if no parameter is optional, <code class="computeroutput">1</code> if the last parameter is optional,
+ <code class="computeroutput">2</code> if the last two parameters
+ are optional, etc. The <code class="computeroutput">defaults</code>
+ template parameter must be between <code class="computeroutput">0</code>
+ and the total number of parameters as specified by <code class="computeroutput">F</code>,
+ it is optional and it is <code class="computeroutput">0</code>
+ by default. For example:
+
+<pre class="programlisting"><code class="computeroutput"><a class="link" href="../boost/local/function.html" title="Struct template function">function</a></code>< int(double, char) > // No default: All parameters must be specified.
+<code class="computeroutput"><a class="link" href="../boost/local/function.html" title="Struct template function">function</a></code>< int(double, char), 1 > // 1 default: The last `char` parameter is optional.
+<code class="computeroutput"><a class="link" href="../boost/local/function.html" title="Struct template function">function</a></code>< int(double, char), 2 > // 2 defaults: All parameters are optional.
+</pre>
+
+ 
+</dd>
+</dl>
+</div>
+
+ For example:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Variadic Macro Syntax (C99 and later compilers)
+ 
+ </th>
+<th>
+ 
+ Sequencing Macro Syntax (all C++ compilers)
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">#include <boost/local/function.hpp>
+#include <boost/function.hpp>
+#include <iostream>
+
+// Using `function` allows to use the same functor for all calls (regardless of
+// which set of default parameters is specified).
+void doit(boost::local::function< int (int, int), 2 > l) {
+ std::cout << l(1, 2) << std::endl;
+ std::cout << l(1) << std::endl;
+ std::cout << l() << std::endl;
+}
+
+// Using `function` requires different functors for calls with different set of
+// default parameters.
+void doit2(boost::function< int (int, int) > l)
+ { std::cout << l(1, 2) << std::endl; }
+void doit1(boost::function< int (int) > l) { std::cout << l(1) << std::endl; }
+void doit0(boost::function< int () > l) { std::cout << l() << std::endl; }
+
+int main() {
+ boost::function<int (int, int)> l2;
+
+ {
+ int i = 2;
+
+ int BOOST_LOCAL_FUNCTION_PARAMS(int x, default 1, int y, default 2,
+ bind i) {
+ return x + i * y;
+ } BOOST_LOCAL_FUNCTION_NAME(linear)
+
+ // Assign local functions variables.
+ boost::local::function< int (int, int), 2 > l = linear;
+ l(1, 2); l(1); l(); // All calls because of default parameters.
+ l2 = linear;
+ l2(1, 2); // Only one call operation (without default parameters).
+
+ // Similarly, pass local functions as a function parameter.
+ doit(linear);
+ std::cout << std::endl;
+ doit2(linear);
+ doit1(linear);
+ doit0(linear);
+ }
+
+ if (false) {
+ l2(1, 2); // This wouuld raise run-time error because invalid reference.
+ }
+
+ return 0;
+}
+</pre>
+
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">#include <boost/local/function.hpp>
+#include <boost/function.hpp>
+#include <iostream>
+
+// Using `function` allows to use the same functor for all calls (regardless of
+// which set of default parameters is specified).
+void doit(boost::local::function< int (int, int), 2 > l) {
+ std::cout << l(1, 2) << std::endl;
+ std::cout << l(1) << std::endl;
+ std::cout << l() << std::endl;
+}
+
+// Using `function` requires different functors for calls with different set of
+// default parameters.
+void doit2(boost::function< int (int, int) > l)
+ { std::cout << l(1, 2) << std::endl; }
+void doit1(boost::function< int (int) > l) { std::cout << l(1) << std::endl; }
+void doit0(boost::function< int () > l) { std::cout << l() << std::endl; }
+
+int main() {
+ boost::function<int (int, int)> l2;
+
+ {
+ int i = 2;
+
+ int BOOST_LOCAL_FUNCTION_PARAMS( (int x)(default 1) (int y)(default 2)
+ (bind i) ) {
+ return x + i * y;
+ } BOOST_LOCAL_FUNCTION_NAME(linear)
+
+ // Assign local functions variables.
+ boost::local::function< int (int, int), 2 > l = linear;
+ l(1, 2); l(1); l(); // All calls because of default parameters.
+ l2 = linear;
+ l2(1, 2); // Only one call operation (without default parameters).
+
+ // Similarly, pass local functions as a function parameter.
+ doit(linear);
+ std::cout << std::endl;
+ doit2(linear);
+ doit1(linear);
+ doit0(linear);
+ }
+
+ if (false) {
+ l2(1, 2); // This wouuld raise run-time error because invalid reference.
+ }
+
+ return 0;
+}
+</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+
+ In addition, a local function can bind and call another local function. For
+ example, the following local function <code class="computeroutput">inc_sum</code>
+ binds the local function <code class="computeroutput">inc</code>
+ so <code class="computeroutput">inc_sum</code> can call <code class="computeroutput">inc</code>:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Variadic Macro Syntax (C99 and later compilers)
+ 
+ </th>
+<th>
+ 
+ Sequencing Macro Syntax (all C++ compilers)
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">#include <boost/local/function.hpp>
+#include <iostream>
+#include <algorithm>
+#include <vector>
+
+int main () {
+ int offset = 5;
+ std::vector<int> v;
+ std::vector<int> w;
+
+ // v = 10 20 30 40 50
+ for (int i = 1; i < 6; i++) v.push_back(i * 10);
+ w.resize(v.size());
+
+ // w = ++v + 5 = 16 26 36 46 56
+ int BOOST_LOCAL_FUNCTION_PARAMS(int i, const bind& offset) {
+ // Compiler error if const `offset` modified here by mistake.
+ return ++i + offset;
+ } BOOST_LOCAL_FUNCTION_NAME(inc)
+ std::transform(v.begin(), v.end(), w.begin(), inc);
+
+ offset = 0;
+
+ // v = ++(v + w) + 0 = 27 47 67 87 107
+ int BOOST_LOCAL_FUNCTION_PARAMS(int i, int j,
+ const bind& inc) { // Bind another local function.
+ return inc(i + j); // Call the bound local function.
+ } BOOST_LOCAL_FUNCTION_NAME(inc_sum)
+ std::transform(v.begin(), v.end(), w.begin(), v.begin(), inc_sum);
+
+ for (std::vector<int>::iterator i = v.begin(); i != v.end(); ++i)
+ { std::cout << " " << *i; }
+ std::cout << std::endl;
+
+ return 0;
+}
+</pre>
+
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">#include <boost/local/function.hpp>
+#include <iostream>
+#include <algorithm>
+#include <vector>
+
+int main () {
+ int offset = 5;
+ std::vector<int> v;
+ std::vector<int> w;
+
+ // v = 10 20 30 40 50
+ for (int i = 1; i < 6; i++) v.push_back(i * 10);
+ w.resize(v.size());
+
+ // w = ++v + 5 = 16 26 36 46 56
+ int BOOST_LOCAL_FUNCTION_PARAMS( (int i) (const bind& offset) ) {
+ // Compiler error if const `offset` modified here by mistake.
+ return ++i + offset;
+ } BOOST_LOCAL_FUNCTION_NAME(inc)
+ std::transform(v.begin(), v.end(), w.begin(), inc);
+
+ offset = 0;
+
+ // v = ++(v + w) + 0 = 27 47 67 87 107
+ int BOOST_LOCAL_FUNCTION_PARAMS( (int i) (int j)
+ (const bind& inc) ) { // Bind another local function.
+ return inc(i + j); // Call the bound local function.
+ } BOOST_LOCAL_FUNCTION_NAME(inc_sum)
+ std::transform(v.begin(), v.end(), w.begin(), v.begin(), inc_sum);
+
+ for (std::vector<int>::iterator i = v.begin(); i != v.end(); ++i)
+ { std::cout << " " << *i; }
+ std::cout << std::endl;
+
+ return 0;
+}
+</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.AdvancedTopics.exception_specifications"></a><a class="link" href="AdvancedTopics.html#boost_local.AdvancedTopics.exception_specifications" title="Exception Specifications">Exception
+ Specifications</a>
+</h3></div></div></div>
+
+ It is possible to program exception specifications for local functions, local
+ blocks, and local exits. Exception specifications are programmed outside
+ the macros and just before the body definition as usual in C++.
+ 
+<div class="important"><table border="0" summary="Important">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Important]" src="../../../../../doc/src/images/important.png"></td>
+<th align="left">Important</th>
+</tr>
+<tr><td align="left" valign="top">
+ However, note that the exception specifications only apply to the body
+ code specified by programmers and they do not apply to the rest of the
+ code automatically generated by the macro expansions to implement local
+ functions, local blocks, and local exits. For example, even if the body
+ code is specified to throw no exception using <code class="computeroutput">throw
+ () { ... }</code>, the
+ execution of the library code automatically generated by the macros could
+ still throw (if there is no memory, etc).
+ </td></tr>
+</table></div>
+
+ For example:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Variadic Macro Syntax (C99 and later compilers)
+ 
+ </th>
+<th>
+ 
+ Sequencing Macro Syntax (all C++ compilers)
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">#include <boost/local/function.hpp>
+#include <boost/local/block.hpp>
+#include <boost/local/exit.hpp>
+#include <stdexcept>
+#include <algorithm>
+#include <cassert>
+
+int main() {
+ double sum = 0.0;
+ int factor = 10;
+
+ void BOOST_LOCAL_FUNCTION_PARAMS(double num,
+ const bind factor, bind& sum)
+ throw (std::runtime_error, std::logic_error) { // Throw two except.
+ sum += factor * num;
+ } BOOST_LOCAL_FUNCTION_NAME(add)
+ add(100.0);
+
+ size_t size = 2;
+ double* nums = new double[size];
+ BOOST_LOCAL_EXIT(const bind& size, bind nums) throw() { // Throw none.
+ if (size && nums) delete[] nums;
+ } BOOST_LOCAL_EXIT_END
+
+ nums[0] = 90.5; nums[1] = 7.0;
+ std::for_each(nums, nums + size, add);
+
+ BOOST_LOCAL_BLOCK(const bind& sum) throw(std::exception) { // Thow one.
+ assert(sum == 1975.0);
+ } BOOST_LOCAL_BLOCK_END
+
+ return 0;
+}
+</pre>
+
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">#include <boost/local/function.hpp>
+#include <boost/local/block.hpp>
+#include <boost/local/exit.hpp>
+#include <stdexcept>
+#include <algorithm>
+#include <cassert>
+
+int main() {
+ double sum = 0.0;
+ int factor = 10;
+
+ void BOOST_LOCAL_FUNCTION_PARAMS( (double num)
+ (const bind factor) (bind& sum) )
+ throw (std::runtime_error, std::logic_error) { // Throw two except.
+ sum += factor * num;
+ } BOOST_LOCAL_FUNCTION_NAME(add)
+ add(100.0);
+
+ size_t size = 2;
+ double* nums = new double[size];
+ BOOST_LOCAL_EXIT( (const bind& size) (bind nums) ) throw() { // Throw none.
+ if (size && nums) delete[] nums;
+ } BOOST_LOCAL_EXIT_END
+
+ nums[0] = 90.5; nums[1] = 7.0;
+ std::for_each(nums, nums + size, add);
+
+ BOOST_LOCAL_BLOCK( (const bind& sum) ) throw(std::exception) { // Thow one.
+ assert(sum == 1975.0);
+ } BOOST_LOCAL_BLOCK_END
+
+ return 0;
+}
+</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.AdvancedTopics.storage_classifiers___auto__and__register__"></a><a class="link" href="AdvancedTopics.html#boost_local.AdvancedTopics.storage_classifiers___auto__and__register__" title="Storage Classifiers (auto and register)">Storage
+ Classifiers (<code class="computeroutput">auto</code> and <code class="computeroutput">register</code>)</a>
+</h3></div></div></div>
+
+ Local function parameters support the storage classifiers as usual in C++.
+ The <code class="computeroutput">auto</code> storage classifier
+ is specified as:
+ 
+<pre class="programlisting">auto parameter-type parameter-name
+</pre>
+
+ and the <code class="computeroutput">register</code> storage classifier
+ is specified as:
+ 
+<pre class="programlisting">register parameter-type parameter-name
+</pre>
+
+ For example:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Variadic Macro Syntax (C99 and later compilers)
+ 
+ </th>
+<th>
+ 
+ Sequencing Macro Syntax (all C++ compilers)
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">#include <boost/local/function.hpp>
+#include <iostream>
+
+int main() {
+ int BOOST_LOCAL_FUNCTION_PARAMS(auto int x, register int y) {
+ return x + y;
+ } BOOST_LOCAL_FUNCTION_NAME(add)
+
+ std::cout << add(3, 5) << std::endl;
+
+ return 0;
+}
+</pre>
+
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">#include <boost/local/function.hpp>
+#include <iostream>
+
+int main() {
+ int BOOST_LOCAL_FUNCTION_PARAMS( (auto int x) (register int y) ) {
+ return x + y;
+ } BOOST_LOCAL_FUNCTION_NAME(add)
+
+ std::cout << add(3, 5) << std::endl;
+
+ return 0;
+}
+</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.AdvancedTopics.recursive_local_functions"></a><a class="link" href="AdvancedTopics.html#boost_local.AdvancedTopics.recursive_local_functions" title="Recursive Local Functions">Recursive
+ Local Functions</a>
+</h3></div></div></div>
+
+ A local function can recursively call itself as usual with C++ functions.
+ 
+
+ For example, the following local function is used to recursively calculate
+ and print the factorial of the specified numbers:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Variadic Macro Syntax (C99 and later compilers)
+ 
+ </th>
+<th>
+ 
+ Sequencing Macro Syntax (all C++ compilers)
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">#include <boost/local/function.hpp>
+#include <iostream>
+#include <sstream>
+#include <algorithm>
+#include <vector>
+
+int main () {
+ std::ostringstream output;
+
+ int BOOST_LOCAL_FUNCTION_PARAMS(int n, bool recursion, default false,
+ bind& output) {
+ int result = 0;
+
+ if (n < 2 ) result = 1;
+ else result = n * factorial(n - 1, true); // Recursive call.
+
+ if (!recursion) output << result << " ";
+ return result;
+ } BOOST_LOCAL_FUNCTION_NAME(factorial)
+
+ std::vector<int> v(3);
+ v[0] = 1; v[1] = 4; v[2] = 7;
+ std::for_each(v.begin(), v.end(), factorial);
+
+ std::cout << output.str() << std::endl;
+ return 0;
+}
+</pre>
+
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">#include <boost/local/function.hpp>
+#include <iostream>
+#include <sstream>
+#include <algorithm>
+#include <vector>
+
+int main () {
+ std::ostringstream output;
+
+ int BOOST_LOCAL_FUNCTION_PARAMS( (int n) (bool recursion)(default false)
+ (bind& output) ) {
+ int result = 0;
+
+ if (n < 2 ) result = 1;
+ else result = n * factorial(n - 1, true); // Recursive call.
+
+ if (!recursion) output << result << " ";
+ return result;
+ } BOOST_LOCAL_FUNCTION_NAME(factorial)
+
+ std::vector<int> v(3);
+ v[0] = 1; v[1] = 4; v[2] = 7;
+ std::for_each(v.begin(), v.end(), factorial);
+
+ std::cout << output.str() << std::endl;
+ return 0;
+}
+</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.AdvancedTopics.nested_declarations"></a><a class="link" href="AdvancedTopics.html#boost_local.AdvancedTopics.nested_declarations" title="Nested Declarations">Nested
+ Declarations</a>
+</h3></div></div></div>
+
+ It is possible to nest local function, local block, and local exit declarations
+ into one another.
+ 
+
+ For example:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Variadic Macro Syntax (C99 and later compilers)
+ 
+ </th>
+<th>
+ 
+ Sequencing Macro Syntax (all C++ compilers)
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">#include <boost/local/function.hpp>
+#include <boost/local/block.hpp>
+#include <boost/local/exit.hpp>
+#include <iostream>
+#include <cassert>
+
+int main() {
+ int x = 0;
+
+ // Local functions nested into one another.
+ void BOOST_LOCAL_FUNCTION_PARAMS(bind& x) {
+ std::cout << "l: " << x << std::endl;
+
+ void BOOST_LOCAL_FUNCTION_PARAMS(bind& x) {
+ std::cout << "m: " << x << std::endl;
+ } BOOST_LOCAL_FUNCTION_NAME(m)
+
+ x--; m();
+ } BOOST_LOCAL_FUNCTION_NAME(l)
+
+ // Local functions, blocks and exits nested into each other.
+ void BOOST_LOCAL_FUNCTION_PARAMS(bind& x) {
+ BOOST_LOCAL_EXIT(bind& x) {
+ x = 0;
+ BOOST_LOCAL_BLOCK(const bind& x) {
+ assert(x == 0);
+ } BOOST_LOCAL_BLOCK_END
+ } BOOST_LOCAL_EXIT_END
+ std::cout << "n: " << x << std::endl;
+ } BOOST_LOCAL_FUNCTION_NAME(n)
+
+ x--; l();
+ x--; n();
+ return 0;
+}
+</pre>
+
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">#include <boost/local/function.hpp>
+#include <boost/local/block.hpp>
+#include <boost/local/exit.hpp>
+#include <iostream>
+#include <cassert>
+
+int main() {
+ int x = 0;
+
+ // Local functions nested into one another.
+ void BOOST_LOCAL_FUNCTION_PARAMS( (bind& x) ) {
+ std::cout << "l: " << x << std::endl;
+
+ void BOOST_LOCAL_FUNCTION_PARAMS( (bind& x) ) {
+ std::cout << "m: " << x << std::endl;
+ } BOOST_LOCAL_FUNCTION_NAME(m)
+
+ x--; m();
+ } BOOST_LOCAL_FUNCTION_NAME(l)
+
+ // Local functions, blocks and exits nested into each other.
+ void BOOST_LOCAL_FUNCTION_PARAMS( (bind& x) ) {
+ BOOST_LOCAL_EXIT( (bind& x) ) {
+ x = 0;
+ BOOST_LOCAL_BLOCK( (const bind& x) ) {
+ assert(x == 0);
+ } BOOST_LOCAL_BLOCK_END
+ } BOOST_LOCAL_EXIT_END
+ std::cout << "n: " << x << std::endl;
+ } BOOST_LOCAL_FUNCTION_NAME(n)
+
+ x--; l();
+ x--; n();
+ return 0;
+}
+</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.AdvancedTopics.limitations__overloading__operators__etc_"></a><a class="link" href="AdvancedTopics.html#boost_local.AdvancedTopics.limitations__overloading__operators__etc_" title="Limitations (overloading, operators, etc)">Limitations
+ (overloading, operators, etc)</a>
+</h3></div></div></div>
+
+ The following table summarizes all the usual C++ function features that are
+ not supported for local functions.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ C++ Function Feature
+ 
+ </th>
+<th>
+ 
+ Local Function Support
+ 
+ </th>
+<th>
+ 
+ Reason
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">export</code>
+ 
+ </td>
+<td>
+ 
+ No
+ 
+ </td>
+<td>
+ 
+ This is not supported because local functions cannot be templates
+ (plus most C++ compilers do not implement <code class="computeroutput">export</code>).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">template<</code>template-parameter-list<code class="computeroutput">></code>
+ 
+ </td>
+<td>
+ 
+ No
+ 
+ </td>
+<td>
+ 
+ This is not supported because local functions are implemented using
+ local classes and C++ local classes cannot be templates.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">explicit</code>
+ 
+ </td>
+<td>
+ 
+ No
+ 
+ </td>
+<td>
+ 
+ This is not supported because local functions are not constructors.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">inline</code>
+ 
+ </td>
+<td>
+ 
+ No
+ 
+ </td>
+<td>
+ 
+ Local functions are always defined together with their declarations
+ so they are always inlined and there is no need to specify them
+ <code class="computeroutput">inline</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">extern</code>
+ 
+ </td>
+<td>
+ 
+ No
+ 
+ </td>
+<td>
+ 
+ This is not supported because local functions are always defined
+ locally within the enclosing scope and together with their declarations.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">static</code>
+ 
+ </td>
+<td>
+ 
+ No
+ 
+ </td>
+<td>
+ 
+ This is not supported because local functions are not member functions.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">virtual</code>
+ 
+ </td>
+<td>
+ 
+ No
+ 
+ </td>
+<td>
+ 
+ This is not supported because local functions are not member functions.
+ 
+ 
+ In theory, it would be possible for a local functor class to inherit
+ from another local functor class. The parenthesized syntax could
+ be extended to specify the eventual base local functor class within
+ the parenthesized signature (e.g., using <code class="computeroutput">...
+ (extends)(</code>base<code class="computeroutput">)</code>). However, this "inheritance"
+ feature is not implemented because it seems of <a href="http://lists.boost.org/Archives/boost/2010/09/170895.php" target="_top">no
+ use</a> given that local functions can be bound to one another
+ thus they can simply call each other directly without recurring
+ to dynamic binding or base function call.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="literal">result-type</code>
+ 
+ </td>
+<td>
+ 
+ Yes
+ 
+ </td>
+<td>
+ 
+ This is supported (see the <a class="link" href="Tutorial.html" title="Tutorial">Tutorial</a>
+ section).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="literal">function-name</code>
+ 
+ </td>
+<td>
+ 
+ Yes
+ 
+ </td>
+<td>
+ 
+ This is supported but it cannot be overloaded and it cannot be
+ an operator (see the <a class="link" href="Tutorial.html" title="Tutorial">Tutorial</a>
+ and <a class="link" href="../">Advanced Topics</a>
+ sections).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="literal">parameter-list</code>
+ 
+ </td>
+<td>
+ 
+ Yes
+ 
+ </td>
+<td>
+ 
+ This is supported and it also supports the <code class="computeroutput">auto</code>
+ and <code class="computeroutput">register</code> storage
+ classifiers, default parameters, and binding of variables in scope
+ (see the <a class="link" href="Tutorial.html" title="Tutorial">Tutorial</a> and
+ <a class="link" href="../">Advanced Topics</a>
+ sections).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ Trailing <code class="computeroutput">const</code> qualifier
+ 
+ </td>
+<td>
+ 
+ No
+ 
+ </td>
+<td>
+ 
+ This is not supported because local functions are not member functions.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ Trailing <code class="computeroutput">volatile</code>
+ qualifier
+ 
+ </td>
+<td>
+ 
+ No
+ 
+ </td>
+<td>
+ 
+ This is not supported because local functions are not member functions.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="boost_local.AdvancedTopics.limitations__overloading__operators__etc_.overloading"></a><h6>
+<a name="id909636"></a>
+ <a class="link" href="AdvancedTopics.html#boost_local.AdvancedTopics.limitations__overloading__operators__etc_.overloading">Overloading</a>
+ </h6>
+
+ It is not possible to overload local functions. Declaring multiple local
+ functions with the same name within the same enclosing scope generates a
+ compile-time error (even if the different declarations specify different
+ parameters). [<a name="id909660" href="#ftn.id909660" class="footnote">18</a>]
+ 
+
+ For example, the following code will not
+ compile:
+ 
+<pre class="programlisting">void f() {
+ void <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>( (const int& i) ) {
+ ...
+ } <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_NAME.html" title="Macro BOOST_LOCAL_FUNCTION_NAME">BOOST_LOCAL_FUNCTION_NAME</a></code>(l)
+
+ void <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>( (const double& d) ) {
+ ...
+ } <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_NAME.html" title="Macro BOOST_LOCAL_FUNCTION_NAME">BOOST_LOCAL_FUNCTION_NAME</a></code>(l) // Error: Cannot overload.
+
+ ...
+}
+</pre>
+<a name="boost_local.AdvancedTopics.limitations__overloading__operators__etc_.operators"></a><h6>
+<a name="id909966"></a>
+ <a class="link" href="AdvancedTopics.html#boost_local.AdvancedTopics.limitations__overloading__operators__etc_.operators">Operators</a>
+ </h6>
+
+ Local functions cannot be operators. Naming a local function <code class="computeroutput">operator...</code>
+ will generate a compile-time error. [<a name="id910003" href="#ftn.id910003" class="footnote">19</a>]
+ 
+
+ For example, the following code will not
+ compile:
+ 
+<pre class="programlisting">void f() {
+ struct point {
+ double x;
+ double y;
+ };
+
+ bool <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>(
+ (const point&)(p) (const point&)(q) ) {
+ return p.x == q.x && p.y == q.y;
+ ) <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_NAME.html" title="Macro BOOST_LOCAL_FUNCTION_NAME">BOOST_LOCAL_FUNCTION_NAME</a></code>(operator==) // Error: Cannot be `operator==`.
+
+ ...
+}
+</pre>
+</div>
+<div class="footnotes">
+ <hr width="100" align="left">
+<div class="footnote">[<a id="ftn.id881888" href="#id881888" class="para">15</a>] 
+ Rationale. This limitation derives from
+ the fact that <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>
+ uses preprocessor token concatenation to inspect the parameter type token
+ to see if the token is a parameter or a bound variable. The C++ preprocessor
+ does not allow to concatenate non-alphanumeric tokens.
+ </div>
+<div class="footnote">[<a id="ftn.id883246" href="#id883246" class="para">16</a>] 
+ Rationale. Using variadic macros,
+ this extra set of parenthesis could be eliminated requiring only the
+ parenthesis to invoke the <code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">BOOST_IDENTITY_TYPE</a></code>
+ macro. However, this feature is currently not implemented and the double
+ parenthesis are always needed when invoking this macro.
+ </div>
+<div class="footnote">[<a id="ftn.id884550" href="#id884550" class="para">17</a>] 
+ The authors recognize that the use of the identity macros
+ adds extra parenthesis to the already significant number of parenthesis
+ required by the sequencing macro syntax. However, macro parameters usually
+ do not contain unwrapped commas <code class="computeroutput">,</code>
+ (unless template metaprogramming is being used) so this is usually not
+ a problem.
+ </div>
+<div class="footnote">[<a id="ftn.id909660" href="#id909660" class="para">18</a>] 
+ Rationale. This is because a local function
+ is a functor object declared as a local variable within the enclosing scope.
+ Therefore, declaring two local functions with the same name within the
+ same enclosing scope declares two local variables with the same name within
+ the same scope and that is not allowed in C++.
+ </div>
+<div class="footnote">[<a id="ftn.id910003" href="#id910003" class="para">19</a>] 
+ Rationale. This is the because a local
+ function name must be a valid local variable name (the local variable to
+ hold the local functor object) and operators cannot be used as local variable
+ names.
+ </div>
+</div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2009 -2011 Lorenzo Caminiti
+ Use, modification, and distribution is subject to the Boost Software License,
+ Version 1.0 (see accompanying file LICENSE_1_0.txt or a copy at http://www.boost.org/LICENSE_1_0.txt).
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="Tutorial.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="../reference.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/local/libs/local/doc/html/boost_local/Advanced_Topics.html
==============================================================================
--- (empty file)
+++ sandbox/local/libs/local/doc/html/boost_local/Advanced_Topics.html 2011-03-18 17:41:51 EDT (Fri, 18 Mar 2011)
@@ -0,0 +1,1972 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Advanced Topics</title>
+<link rel="stylesheet" href="../../../../../doc/src/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
+<link rel="home" href="../index.html" title="Boost.Local 0.1.1">
+<link rel="up" href="../index.html" title="Boost.Local 0.1.1">
+<link rel="prev" href="Tutorial.html" title="Tutorial">
+<link rel="next" href="../reference.html" title="Reference">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="Tutorial.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="../reference.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="boost_local.Advanced_Topics"></a><a class="link" href="Advanced_Topics.html" title="Advanced Topics">Advanced Topics</a>
+</h2></div></div></div>
+<div class="toc"><dl>
+<dt><a href="Advanced_Topics.html#boost_local.Advanced_Topics.commas_and_symbols_in_macro_parameters">Commas
+ and Symbols in Macro Parameters</a></dt>
+<dt><a href="Advanced_Topics.html#boost_local.Advanced_Topics.deducing_bound_types__concepts__etc_">Deducing
+ Bound Types (concepts, etc)</a></dt>
+<dt><a href="Advanced_Topics.html#boost_local.Advanced_Topics.passing_local_functions">Passing
+ Local Functions</a></dt>
+<dt><a href="Advanced_Topics.html#boost_local.Advanced_Topics.exception_specifications">Exception
+ Specifications</a></dt>
+<dt><a href="Advanced_Topics.html#boost_local.Advanced_Topics.storage_classifiers___auto__and__register__">Storage
+ Classifiers (<code class="computeroutput">auto</code> and <code class="computeroutput">register</code>)</a></dt>
+<dt><a href="Advanced_Topics.html#boost_local.Advanced_Topics.recursive_local_functions">Recursive
+ Local Functions</a></dt>
+<dt><a href="Advanced_Topics.html#boost_local.Advanced_Topics.nested_declarations">Nested
+ Declarations</a></dt>
+<dt><a href="Advanced_Topics.html#boost_local.Advanced_Topics.limitations__overloading__operators__etc_">Limitations
+ (overloading, operators, etc)</a></dt>
+</dl></div>
+
+ This section illustrates advanced usage of this library. At the end of this
+ section there is also a list of knwon limitations of this library.
+ 
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Advanced_Topics.commas_and_symbols_in_macro_parameters"></a><a class="link" href="Advanced_Topics.html#boost_local.Advanced_Topics.commas_and_symbols_in_macro_parameters" title="Commas and Symbols in Macro Parameters">Commas
+ and Symbols in Macro Parameters</a>
+</h3></div></div></div>
+
+ The C++ preprocessor does not allow commas <code class="computeroutput">,</code>
+ within macro parameters unless they are wrapped by the round parenthesis
+ <code class="computeroutput">()</code>. Therefore, using commas
+ within the local function parameters and bindings will generate (cryptic)
+ preprocessor errors unless they are wrapped within extra round parenthesis
+ <code class="computeroutput">()</code> as explained here.
+ 
+<div class="note"><table border="0" summary="Note">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../../../../../doc/src/images/note.png"></td>
+<th align="left">Note</th>
+</tr>
+<tr><td align="left" valign="top">
+ Macro parameters with commas which are
+ already wrapped by round parenthesis <code class="computeroutput">()</code>
+ are fine (function calls, etc). However, macro parameters with commas that
+ are not wrapped by round parenthesis need to be wrapped by an extra set
+ of round parenthesis <code class="computeroutput">()</code> as
+ described here. Also macro parameters with commas wrapped by angular parenthesis
+ <code class="computeroutput"><></code> (templates, etc)
+ or square parenthesis <code class="computeroutput">[]</code> (multidimensional
+ array access, etc) need to be wrapped by the extra round parenthesis <code class="computeroutput">()</code> as explained here (this is because the
+ preprocessor only recognizes the round parenthesis and it does not recognize
+ angular, square, or any other type of parenthesis).
+ </td></tr>
+</table></div>
+
+ In addition, local function parameter types cannot start with non-alphanumeric
+ symbols (alphanumeric symbols are <code class="computeroutput">A-Z</code>, <code class="computeroutput">a-z</code>,
+ and <code class="computeroutput">0-9</code>). [<a name="id881890" href="#ftn.id881890" class="footnote">15</a>] The library will generate (cryptic) preprocessor errors if a
+ parameter type starts with a non-alphanumeric symbol.
+ 
+
+ Let's consider the following example:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Variadic Macro Syntax (C99 and later compilers)
+ 
+ </th>
+<th>
+ 
+ Sequencing Macro Syntax (all C++ compilers)
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">... <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>(
+ const std::map<std::string, size_t>& m, // (1) Error.
+ ::sign_t sign, // (2) Error.
+ const size_t& factor, default
+ key_size<std::string, size_t>::value, // (3) Error.
+ const std::string& separator, default cat(":", " "), // (4) OK.
+) ...
+</pre>
+
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">... <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>(
+ (const std::map<std::string, size_t>& m) // (1) Error.
+ (::sign_t sign) // (2) Error.
+ (const size_t& factor)(default
+ key_size<std::string, size_t>::value) // (3) Error.
+ (const std::string& separator)(default cat(":", " ")) // (4) OK.
+) ...
+</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+
+ (1) The parameter type <code class="computeroutput">const
+ std::map<std::string, size_t>&</code> contains a comma <code class="computeroutput">,</code>
+ after the first template parameter <code class="computeroutput">std::string</code>.
+ This comma is not wrapped by any round parenthesis <code class="computeroutput">()</code>
+ (the outer parenthesis <code class="computeroutput">()</code> that
+ make the sequencing macro syntax do not count) thus it will cause a preprocessor
+ error. The macro <code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">BOOST_IDENTITY_TYPE</a>(</code>parenthesized-type<code class="computeroutput">)</code> can be used to wrap a type within extra
+ parenthesis <code class="computeroutput">()</code> so to overcome
+ this issue:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Variadic Macro Syntax (C99 and later compilers)
+ 
+ </th>
+<th>
+ 
+ Sequencing Macro Syntax (all C++ compilers)
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">... <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>(
+ <code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">BOOST_IDENTITY_TYPE</a></code>((const std::map<std::string, size_t>&)) m, // OK.
+ ...
+) ...
+</pre>
+
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">... <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>(
+ (<code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">BOOST_IDENTITY_TYPE</a></code>((const std::map<std::string, size_t>&)) m) // OK.
+ ...
+) ...
+</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+
+ This macro expands to an expression that evaluates (at compile-time) exactly
+ to the specified type. Note that a total of two set of parenthesis <code class="computeroutput">()</code> are added:
+ 
+<div class="orderedlist"><ol class="orderedlist" type="1">
+<li class="listitem">
+ Parenthesis to invoke the <code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">BOOST_IDENTITY_TYPE</a></code>
+ macro.
+ </li>
+<li class="listitem">
+ Parenthesis to wrap the type expression (and therefore any commas <code class="computeroutput">,</code> that it contains) passed as parameter
+ to the <code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">BOOST_IDENTITY_TYPE</a></code>
+ macro. [<a name="id883247" href="#ftn.id883247" class="footnote">16</a>]
+ </li>
+</ol></div>
+
+ (2) The parameter type <code class="computeroutput">::sign_t</code> start with the non-alphanumeric
+ symbols <code class="computeroutput">::</code> thus it will generate
+ preprocessor errors if used as a local function parameter type. The macros
+ <code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">BOOST_IDENTITY_TYPE</a></code>
+ can also be used to overcome this issue:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Variadic Macro Syntax (C99 and later compilers)
+ 
+ </th>
+<th>
+ 
+ Sequencing Macro Syntax (all C++ compilers)
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">... <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>(
+ ...
+ <code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">BOOST_IDENTITY_TYPE</a></code>((::sign_t)) sign, // OK.
+ ...
+) ...
+</pre>
+
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">... <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>(
+ ...
+ (<code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">BOOST_IDENTITY_TYPE</a></code>((::sign_t)) sign) // OK.
+ ...
+) ...
+</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+
+ Often, there might be better ways to overcome this limitation that lead to
+ code which is more readable than the one using the <code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">BOOST_IDENTITY_TYPE</a></code>
+ macro. For example, in this case the symbols <code class="computeroutput">::</code>
+ could have been simply dropped to obtain the following valid and more readable
+ code:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Variadic Macro Syntax (C99 and later compilers)
+ 
+ </th>
+<th>
+ 
+ Sequencing Macro Syntax (all C++ compilers)
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">... <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>(
+ ...
+ sign_t sign, // OK.
+ ...
+) ...
+</pre>
+
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">... <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>(
+ ...
+ (sign_t sign) // OK.
+ ...
+) ...
+</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+
+ (3) The default parameter value <code class="computeroutput">key_size<std::string, size_t>::value</code>
+ contains a comma <code class="computeroutput">,</code> after the
+ first template parameter <code class="computeroutput">std::string</code>.
+ Again, this comma is not wrapped by any parenthesis <code class="computeroutput">()</code>
+ so it will cause a preprocessor error. Because this is a value expression
+ (and not a type expression), it can be simply wrapped within an extra set
+ of round parenthesis <code class="computeroutput">()</code>:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Variadic Macro Syntax (C99 and later compilers)
+ 
+ </th>
+<th>
+ 
+ Sequencing Macro Syntax (all C++ compilers)
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">... <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>(
+ ...
+ const size_t& factor, default
+ (key_size<std::string, size_t>::value), // OK.
+ ...
+) ...
+</pre>
+
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">... <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>(
+ ...
+ (const size_t& factor)(default
+ (key_size<std::string, size_t>::value)) // OK.
+ ...
+) ...
+</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+<div class="note"><table border="0" summary="Note">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../../../../../doc/src/images/note.png"></td>
+<th align="left">Note</th>
+</tr>
+<tr><td align="left" valign="top">
+ Alternatively, the macro <code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_VALUE.html" title="Macro BOOST_IDENTITY_VALUE">BOOST_IDENTITY_VALUE</a>(</code>parenthesized-value<code class="computeroutput">)</code> could have been used. This macro expands
+ to an expression that evaluates (at run-time) exactly to the specified
+ value -- but it adds overhead compared with simply using the extra parenthesis
+ <code class="computeroutput">()</code>. Note that, similarly to
+ <code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">BOOST_IDENTITY_TYPE</a></code>,
+ the <code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_VALUE.html" title="Macro BOOST_IDENTITY_VALUE">BOOST_IDENTITY_VALUE</a></code>
+ macro also requires two sets of extra parenthesis one set for invoking
+ the macro and another set to wrap the value expression passed as the macro
+ parameter.
+ </td></tr>
+</table></div>
+
+ (4) The default parameter value <code class="computeroutput">cat(":", " ")</code> is instead fine because it contains a comma
+ <code class="computeroutput">,</code> which is already wrapped by
+ the parenthesis <code class="computeroutput">()</code> of the function
+ call <code class="computeroutput">cat(...)</code>.
+ 
+<div class="important"><table border="0" summary="Important">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Important]" src="../../../../../doc/src/images/important.png"></td>
+<th align="left">Important</th>
+</tr>
+<tr><td align="left" valign="top">
+ The <code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">BOOST_IDENTITY_TYPE</a></code>
+ macro must be prefixed by the <code class="computeroutput">typename</code>
+ keyword when used within templates.
+ </td></tr>
+</table></div>
+
+ Consider the following complete example: [<a name="id884552" href="#ftn.id884552" class="footnote">17</a>]
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Variadic Macro Syntax (C99 and later compilers)
+ 
+ </th>
+<th>
+ 
+ Sequencing Macro Syntax (all C++ compilers)
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">#include <boost/local/function.hpp>
+#include <boost/utility/identity.hpp>
+#include <map>
+#include <string>
+#include <iostream>
+
+template<typename K, typename T> struct key_size { static const size_t value; };
+template<typename K, typename T> const size_t key_size<K, T>::value = sizeof(K);
+
+std::string cat(const std::string& a, const std::string& b) { return a + b; }
+
+typedef int const& sign_t;
+
+int main() {
+ void BOOST_LOCAL_FUNCTION_PARAMS(
+ // Identity macros handle commas.
+ BOOST_IDENTITY_TYPE((const std::map<std::string, size_t>))& m,
+ // Also, identity macros handle leading symbols.
+ BOOST_IDENTITY_TYPE((::sign_t)) sign, default -1,
+ const size_t& factor, default // Or use `BOOST_IDENTITY_VALE`.
+ (key_size<std::string, size_t>::value),
+ const std::string& separator, default cat(":", " ")) {
+ for (std::map<std::string, size_t>::const_iterator i = m.begin();
+ i != m.end(); ++i) {
+ std::cout << i->first << separator <<
+ sign * int(i->second) * int(factor) << std::endl;
+ }
+ } BOOST_LOCAL_FUNCTION_NAME(print)
+
+ std::map<std::string, size_t> sizes;
+ sizes["a"] = 1; sizes["ab"] = 2; sizes["abc"] = 3;
+ print(sizes);
+
+ return 0;
+}
+</pre>
+
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">#include <boost/local/function.hpp>
+#include <boost/utility/identity.hpp>
+#include <map>
+#include <string>
+#include <iostream>
+
+template<typename K, typename T> struct key_size { static const size_t value; };
+template<typename K, typename T> const size_t key_size<K, T>::value = sizeof(K);
+
+std::string cat(const std::string& a, const std::string& b) { return a + b; }
+
+typedef int const& sign_t;
+
+int main() {
+ void BOOST_LOCAL_FUNCTION_PARAMS(
+ // Identity macros handle commas.
+ (BOOST_IDENTITY_TYPE((const std::map<std::string, size_t>))& m)
+ // Also, identity macros handle leading symbols.
+ (BOOST_IDENTITY_TYPE((::sign_t)) sign)(default -1)
+ (const size_t& factor)(default // Or use `BOOST_IDENTITY_VALUE`.
+ (key_size<std::string, size_t>::value))
+ (const std::string& separator)(default cat(":", " ")) ) {
+ for (std::map<std::string, size_t>::const_iterator i = m.begin();
+ i != m.end(); ++i) {
+ std::cout << i->first << separator <<
+ sign * int(i->second) * int(factor) << std::endl;
+ }
+ } BOOST_LOCAL_FUNCTION_NAME(print)
+
+ std::map<std::string, size_t> sizes;
+ sizes["a"] = 1; sizes["ab"] = 2; sizes["abc"] = 3;
+ print(sizes);
+
+ return 0;
+}
+</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Advanced_Topics.deducing_bound_types__concepts__etc_"></a><a class="link" href="Advanced_Topics.html#boost_local.Advanced_Topics.deducing_bound_types__concepts__etc_" title="Deducing Bound Types (concepts, etc)">Deducing
+ Bound Types (concepts, etc)</a>
+</h3></div></div></div>
+
+ While the ISO C++ standard does not allow for member functions of local classes
+ to have template parameters, this library allows to call template functions
+ from within a local function, a local block, or a local exit passing bound
+ variables without explicitly specifying their types. This essentially allows
+ local functions, local blocks, and local exits to be polymorphic
+ in the type of the bound variables (like a template is polymorphic in the
+ type of its template parameters).
+ 
+
+ Furthermore, this library allow to access the type of the bound variables
+ from within the local function, local block, or local exit using the following
+ macro:
+ 
+<pre class="programlisting">#include <boost/local/typeof.hpp>
+
+... // Within a local function, local block, or local exit.
+<code class="computeroutput"><a class="link" href="../BOOST_LOCAL_TYPEOF.html" title="Macro BOOST_LOCAL_TYPEOF">BOOST_LOCAL_TYPEOF</a></code>(bound-variable) ...
+...
+</pre>
+
+ This macro expands to a type expression that evaluates (at compile-time)
+ to the fully qualified type of the specified bound variable.
+ 
+<div class="note"><table border="0" summary="Note">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../../../../../doc/src/images/note.png"></td>
+<th align="left">Note</th>
+</tr>
+<tr><td align="left" valign="top">
+ This type expression is fully qualified in the sense that it will be constant
+ if the variable is bound by constant and it will also be a reference is
+ the variable is bound by reference (if needed, programmers can strip away
+ the <code class="computeroutput">const</code> and <code class="computeroutput">&</code> qualifiers using <code class="computeroutput">boost::remove_const</code>
+ and <code class="computeroutput">boost::remove_reference</code>, or similar template
+ metafunctions).
+ </td></tr>
+</table></div>
+
+ The deduced bound type can be used within the body to declare a local variable,
+ to check concepts, etc. For example:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Variadic Macro Syntax (C99 and later compilers)
+ 
+ </th>
+<th>
+ 
+ Sequencing Macro Syntax (all C++ compilers)
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">#include <boost/local/function.hpp>
+#include <boost/local/block.hpp>
+#include <boost/local/exit.hpp>
+#include <boost/local/typeof.hpp> // Typeof header.
+#include <boost/type_traits.hpp>
+#include <boost/concept_check.hpp>
+#include <algorithm>
+#include <cassert>
+
+double total(const double& x, const double& y, const double& z) {
+ double sum = double();
+ int factor = 10;
+
+ double BOOST_LOCAL_FUNCTION_PARAMS(double num, const bind factor,
+ bind& sum) {
+ // Typeof for variable declaration.
+ BOOST_LOCAL_TYPEOF(factor) f = factor;
+ return sum += f * num;
+ } BOOST_LOCAL_FUNCTION_NAME(add)
+ add(x);
+
+ size_t size = 2;
+ double* nums = new double[size];
+ BOOST_LOCAL_EXIT(const bind& size, bind nums) {
+ // Typeof is qualified with eventual bind's `const` and `&`.
+ boost::remove_const<boost::remove_reference<
+ BOOST_LOCAL_TYPEOF(size)>::type>::type s;
+ s = size;
+ if (s && nums) delete[] nums;
+ } BOOST_LOCAL_EXIT_END
+
+ nums[0] = y; nums[1] = z;
+ std::for_each(nums, nums + size, add);
+
+ BOOST_LOCAL_BLOCK(const bind &sum, const bind& factor,
+ const bind& x, const bind& y, const bind& z) {
+ // Typeof for concept checking.
+ BOOST_CONCEPT_ASSERT((boost::EqualityComparable<
+ BOOST_LOCAL_TYPEOF(sum)>));
+ assert(sum == factor * (x + y + z));
+ } BOOST_LOCAL_BLOCK_END
+
+ return sum;
+}
+
+int main() {
+ total(100.0, 90.5, 7.0);
+ return 0;
+}
+</pre>
+
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">#include <boost/local/function.hpp>
+#include <boost/local/block.hpp>
+#include <boost/local/exit.hpp>
+#include <boost/local/typeof.hpp> // Typeof header.
+#include <boost/type_traits.hpp>
+#include <boost/concept_check.hpp>
+#include <algorithm>
+#include <cassert>
+
+double total(const double& x, const double& y, const double& z) {
+ double sum = double();
+ int factor = 10;
+
+ double BOOST_LOCAL_FUNCTION_PARAMS( (double num) (const bind factor)
+ (bind& sum) ) {
+ // Typeof for variable declaration.
+ BOOST_LOCAL_TYPEOF(factor) f = factor;
+ return sum += f * num;
+ } BOOST_LOCAL_FUNCTION_NAME(add)
+ add(x);
+
+ size_t size = 2;
+ double* nums = new double[size];
+ BOOST_LOCAL_EXIT( (const bind& size) (bind nums) ) {
+ // Typeof is qualified with eventual bind's `const` and `&`.
+ boost::remove_const<boost::remove_reference<
+ BOOST_LOCAL_TYPEOF(size)>::type>::type s;
+ s = size;
+ if (s && nums) delete[] nums;
+ } BOOST_LOCAL_EXIT_END
+
+ nums[0] = y; nums[1] = z;
+ std::for_each(nums, nums + size, add);
+
+ BOOST_LOCAL_BLOCK( (const bind &sum) (const bind& factor)
+ (const bind& x) (const bind& y) (const bind& z) ) {
+ // Typeof for concept checking.
+ BOOST_CONCEPT_ASSERT((boost::EqualityComparable<
+ BOOST_LOCAL_TYPEOF(sum)>));
+ assert(sum == factor * (x + y + z));
+ } BOOST_LOCAL_BLOCK_END
+
+ return sum;
+}
+
+int main() {
+ total(100.0, 90.5, 7.0);
+ return 0;
+}
+</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+
+ Within templates, <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_TYPEOF.html" title="Macro BOOST_LOCAL_TYPEOF">BOOST_LOCAL_TYPEOF</a></code>
+ does not require to be prefixed by the <code class="computeroutput">typename</code>
+ keyword but eventual type manipulations need the <code class="computeroutput">typename</code>
+ prefix as usual:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Variadic Macro Syntax (C99 and later compilers)
+ 
+ </th>
+<th>
+ 
+ Sequencing Macro Syntax (all C++ compilers)
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">#include <boost/local/function.hpp>
+#include <boost/local/block.hpp>
+#include <boost/local/exit.hpp>
+#include <boost/local/typeof.hpp> // Typeof header.
+#include <boost/type_traits.hpp>
+#include <boost/concept_check.hpp>
+#include <algorithm>
+#include <cassert>
+
+template<typename T>
+T total(const T& x, const T& y, const T& z) {
+ T sum = T();
+ int factor = 10;
+
+ T BOOST_LOCAL_FUNCTION_PARAMS_TPL(T num, const bind factor,
+ bind& sum) {
+ // Typeof for variable declaratin.
+ BOOST_LOCAL_TYPEOF(factor) f = factor;
+ return sum += f * num;
+ } BOOST_LOCAL_FUNCTION_NAME(add)
+ add(x);
+
+ size_t size = 2;
+ T* nums = new T[size];
+ BOOST_LOCAL_EXIT_TPL(const bind& size, bind nums) {
+ // Typeof is qualified with eventual bind's `const` and `&`.
+ boost::remove_const<boost::remove_reference<
+ BOOST_LOCAL_TYPEOF(size)>::type>::type s;
+ s = size;
+ if (s && nums) delete[] nums;
+ } BOOST_LOCAL_EXIT_END
+
+ nums[0] = y; nums[1] = z;
+ std::for_each(nums, nums + size, add);
+
+ BOOST_LOCAL_BLOCK_TPL(const bind &sum, const bind& factor,
+ const bind& x, const bind& y, const bind& z) {
+ // Tyepof for concept checking.
+ BOOST_CONCEPT_ASSERT((boost::EqualityComparable<
+ BOOST_LOCAL_TYPEOF(sum)>));
+ assert(sum == factor * (x + y + z));
+ } BOOST_LOCAL_BLOCK_END
+
+ return sum;
+}
+
+int main() {
+ total(100.0, 90.5, 7.0);
+ return 0;
+}
+</pre>
+
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">#include <boost/local/function.hpp>
+#include <boost/local/block.hpp>
+#include <boost/local/exit.hpp>
+#include <boost/local/typeof.hpp> // Typeof header.
+#include <boost/type_traits.hpp>
+#include <boost/concept_check.hpp>
+#include <algorithm>
+#include <cassert>
+
+template<typename T>
+T total(const T& x, const T& y, const T& z) {
+ T sum = T();
+ int factor = 10;
+
+ T BOOST_LOCAL_FUNCTION_PARAMS_TPL( (T num) (const bind factor)
+ (bind& sum) ) {
+ // Typeof for variable declaration.
+ BOOST_LOCAL_TYPEOF(factor) f = factor;
+ return sum += f * num;
+ } BOOST_LOCAL_FUNCTION_NAME(add)
+ add(x);
+
+ size_t size = 2;
+ T* nums = new T[size];
+ BOOST_LOCAL_EXIT_TPL( (const bind& size) (bind nums) ) {
+ // Typeof is qualified with eventual bind's `const` and `&`.
+ boost::remove_const<boost::remove_reference<
+ BOOST_LOCAL_TYPEOF(size)>::type>::type s;
+ s = size;
+ if (s && nums) delete[] nums;
+ } BOOST_LOCAL_EXIT_END
+
+ nums[0] = y; nums[1] = z;
+ std::for_each(nums, nums + size, add);
+
+ BOOST_LOCAL_BLOCK_TPL( (const bind &sum) (const bind& factor)
+ (const bind& x) (const bind& y) (const bind& z) ) {
+ // Typeof for concept checking.
+ BOOST_CONCEPT_ASSERT((boost::EqualityComparable<
+ BOOST_LOCAL_TYPEOF(sum)>));
+ assert(sum == factor * (x + y + z));
+ } BOOST_LOCAL_BLOCK_END
+
+ return sum;
+}
+
+int main() {
+ total(100.0, 90.5, 7.0);
+ return 0;
+}
+</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Advanced_Topics.passing_local_functions"></a><a class="link" href="Advanced_Topics.html#boost_local.Advanced_Topics.passing_local_functions" title="Passing Local Functions">Passing
+ Local Functions</a>
+</h3></div></div></div>
+
+ Local functions can be used as functors. For example, it is possible to assign
+ a local function to a functor parameter (using <code class="computeroutput">boost::function</code>,
+ etc) in order to pass the local function to another function. However, it
+ is in general recommended to use the <code class="computeroutput">boost::local::<a class="link" href="../boost/local/function.html" title="Struct template function">function</a></code>
+ functor because it supports default parameters.
+ 
+<div class="important"><table border="0" summary="Important">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Important]" src="../../../../../doc/src/images/important.png"></td>
+<th align="left">Important</th>
+</tr>
+<tr><td align="left" valign="top">
+ When assigning a local function to a functor, programmers need to make
+ sure that the local function survives the scope of
+ the functor otherwise the functor will be invalid and its use
+ will generate a run-time error (as usual with C++ functors).
+ </td></tr>
+</table></div>
+
+ The <code class="computeroutput">boost::local::<a class="link" href="../boost/local/function.html" title="Struct template function">function</a></code> template takes two
+ parameters (see the Reference section):
+ 
+<pre class="programlisting">template< typename F, size_t defaults = 0 > class <code class="computeroutput"><a class="link" href="../boost/local/function.html" title="Struct template function">function</a></code>;
+</pre>
+<div class="variablelist">
+
+<dl>
+<dt>F</dt>
+<dd>
+
+ The template parameter <code class="computeroutput">F</code>
+ is a function type specifying the function signature using the same
+ syntax as Boost.Function's
+ preferred syntax. For example:
+
+<pre class="programlisting"><code class="computeroutput"><a class="link" href="../boost/local/function.html" title="Struct template function">function</a></code>< int() > // Returns `int` and takes no parameter.
+<code class="computeroutput"><a class="link" href="../boost/local/function.html" title="Struct template function">function</a></code>< int(double, char) > // Returns `int`and takes two parameters: a `double` followed by a `char`.
+</pre>
+
+ 
+</dd>
+<dt>defaults</dt>
+<dd>
+
+ The template parameter <code class="computeroutput">defaults</code>
+ is a non-negative integer number specifying the number of defaults
+ parameters (counting from the last parameter as usual): <code class="computeroutput">0</code> if no parameter is optional, <code class="computeroutput">1</code> if the last parameter is optional,
+ <code class="computeroutput">2</code> if the last two parameters
+ are optional, etc. The <code class="computeroutput">defaults</code>
+ template parameter must be between <code class="computeroutput">0</code>
+ and the total number of parameters as specified by <code class="computeroutput">F</code>,
+ it is optional and it is <code class="computeroutput">0</code>
+ by default. For example:
+
+<pre class="programlisting"><code class="computeroutput"><a class="link" href="../boost/local/function.html" title="Struct template function">function</a></code>< int(double, char) > // No default: All parameters must be specified.
+<code class="computeroutput"><a class="link" href="../boost/local/function.html" title="Struct template function">function</a></code>< int(double, char), 1 > // 1 default: The last `char` parameter is optional.
+<code class="computeroutput"><a class="link" href="../boost/local/function.html" title="Struct template function">function</a></code>< int(double, char), 2 > // 2 defaults: All parameters are optional.
+</pre>
+
+ 
+</dd>
+</dl>
+</div>
+
+ For example:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Variadic Macro Syntax (C99 and later compilers)
+ 
+ </th>
+<th>
+ 
+ Sequencing Macro Syntax (all C++ compilers)
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">#include <boost/local/function.hpp>
+#include <boost/function.hpp>
+#include <iostream>
+
+// Using `function` allows to use the same functor for all calls (regardless of
+// which set of default parameters is specified).
+void doit(boost::local::function< int (int, int), 2 > l) {
+ std::cout << l(1, 2) << std::endl;
+ std::cout << l(1) << std::endl;
+ std::cout << l() << std::endl;
+}
+
+// Using `function` requires different functors for calls with different set of
+// default parameters.
+void doit2(boost::function< int (int, int) > l)
+ { std::cout << l(1, 2) << std::endl; }
+void doit1(boost::function< int (int) > l) { std::cout << l(1) << std::endl; }
+void doit0(boost::function< int () > l) { std::cout << l() << std::endl; }
+
+int main() {
+ boost::function<int (int, int)> l2;
+
+ {
+ int i = 2;
+
+ int BOOST_LOCAL_FUNCTION_PARAMS(int x, default 1, int y, default 2,
+ bind i) {
+ return x + i * y;
+ } BOOST_LOCAL_FUNCTION_NAME(linear)
+
+ // Assign local functions variables.
+ boost::local::function< int (int, int), 2 > l = linear;
+ l(1, 2); l(1); l(); // All calls because of default parameters.
+ l2 = linear;
+ l2(1, 2); // Only one call operation (without default parameters).
+
+ // Similarly, pass local functions as a function parameter.
+ doit(linear);
+ std::cout << std::endl;
+ doit2(linear);
+ doit1(linear);
+ doit0(linear);
+ }
+
+ if (false) {
+ l2(1, 2); // This wouuld raise run-time error because invalid reference.
+ }
+
+ return 0;
+}
+</pre>
+
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">#include <boost/local/function.hpp>
+#include <boost/function.hpp>
+#include <iostream>
+
+// Using `function` allows to use the same functor for all calls (regardless of
+// which set of default parameters is specified).
+void doit(boost::local::function< int (int, int), 2 > l) {
+ std::cout << l(1, 2) << std::endl;
+ std::cout << l(1) << std::endl;
+ std::cout << l() << std::endl;
+}
+
+// Using `function` requires different functors for calls with different set of
+// default parameters.
+void doit2(boost::function< int (int, int) > l)
+ { std::cout << l(1, 2) << std::endl; }
+void doit1(boost::function< int (int) > l) { std::cout << l(1) << std::endl; }
+void doit0(boost::function< int () > l) { std::cout << l() << std::endl; }
+
+int main() {
+ boost::function<int (int, int)> l2;
+
+ {
+ int i = 2;
+
+ int BOOST_LOCAL_FUNCTION_PARAMS( (int x)(default 1) (int y)(default 2)
+ (bind i) ) {
+ return x + i * y;
+ } BOOST_LOCAL_FUNCTION_NAME(linear)
+
+ // Assign local functions variables.
+ boost::local::function< int (int, int), 2 > l = linear;
+ l(1, 2); l(1); l(); // All calls because of default parameters.
+ l2 = linear;
+ l2(1, 2); // Only one call operation (without default parameters).
+
+ // Similarly, pass local functions as a function parameter.
+ doit(linear);
+ std::cout << std::endl;
+ doit2(linear);
+ doit1(linear);
+ doit0(linear);
+ }
+
+ if (false) {
+ l2(1, 2); // This wouuld raise run-time error because invalid reference.
+ }
+
+ return 0;
+}
+</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+
+ In addition, a local function can bind and call another local function. For
+ example, the following local function <code class="computeroutput">inc_sum</code>
+ binds the local function <code class="computeroutput">inc</code>
+ so <code class="computeroutput">inc_sum</code> can call <code class="computeroutput">inc</code>:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Variadic Macro Syntax (C99 and later compilers)
+ 
+ </th>
+<th>
+ 
+ Sequencing Macro Syntax (all C++ compilers)
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">#include <boost/local/function.hpp>
+#include <iostream>
+#include <algorithm>
+#include <vector>
+
+int main () {
+ int offset = 5;
+ std::vector<int> v;
+ std::vector<int> w;
+
+ // v = 10 20 30 40 50
+ for (int i = 1; i < 6; i++) v.push_back(i * 10);
+ w.resize(v.size());
+
+ // w = ++v + 5 = 16 26 36 46 56
+ int BOOST_LOCAL_FUNCTION_PARAMS(int i, const bind& offset) {
+ // Compiler error if const `offset` modified here by mistake.
+ return ++i + offset;
+ } BOOST_LOCAL_FUNCTION_NAME(inc)
+ std::transform(v.begin(), v.end(), w.begin(), inc);
+
+ offset = 0;
+
+ // v = ++(v + w) + 0 = 27 47 67 87 107
+ int BOOST_LOCAL_FUNCTION_PARAMS(int i, int j,
+ const bind& inc) { // Bind another local function.
+ return inc(i + j); // Call the bound local function.
+ } BOOST_LOCAL_FUNCTION_NAME(inc_sum)
+ std::transform(v.begin(), v.end(), w.begin(), v.begin(), inc_sum);
+
+ for (std::vector<int>::iterator i = v.begin(); i != v.end(); ++i)
+ { std::cout << " " << *i; }
+ std::cout << std::endl;
+
+ return 0;
+}
+</pre>
+
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">#include <boost/local/function.hpp>
+#include <iostream>
+#include <algorithm>
+#include <vector>
+
+int main () {
+ int offset = 5;
+ std::vector<int> v;
+ std::vector<int> w;
+
+ // v = 10 20 30 40 50
+ for (int i = 1; i < 6; i++) v.push_back(i * 10);
+ w.resize(v.size());
+
+ // w = ++v + 5 = 16 26 36 46 56
+ int BOOST_LOCAL_FUNCTION_PARAMS( (int i) (const bind& offset) ) {
+ // Compiler error if const `offset` modified here by mistake.
+ return ++i + offset;
+ } BOOST_LOCAL_FUNCTION_NAME(inc)
+ std::transform(v.begin(), v.end(), w.begin(), inc);
+
+ offset = 0;
+
+ // v = ++(v + w) + 0 = 27 47 67 87 107
+ int BOOST_LOCAL_FUNCTION_PARAMS( (int i) (int j)
+ (const bind& inc) ) { // Bind another local function.
+ return inc(i + j); // Call the bound local function.
+ } BOOST_LOCAL_FUNCTION_NAME(inc_sum)
+ std::transform(v.begin(), v.end(), w.begin(), v.begin(), inc_sum);
+
+ for (std::vector<int>::iterator i = v.begin(); i != v.end(); ++i)
+ { std::cout << " " << *i; }
+ std::cout << std::endl;
+
+ return 0;
+}
+</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Advanced_Topics.exception_specifications"></a><a class="link" href="Advanced_Topics.html#boost_local.Advanced_Topics.exception_specifications" title="Exception Specifications">Exception
+ Specifications</a>
+</h3></div></div></div>
+
+ It is possible to program exception specifications for local functions, local
+ blocks, and local exits. Exception specifications are programmed outside
+ the macros and just before the body definition as usual in C++.
+ 
+<div class="important"><table border="0" summary="Important">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Important]" src="../../../../../doc/src/images/important.png"></td>
+<th align="left">Important</th>
+</tr>
+<tr><td align="left" valign="top">
+ However, note that the exception specifications only apply to the body
+ code specified by programmers and they do not apply to the rest of the
+ code automatically generated by the macro expansions to implement local
+ functions, local blocks, and local exits. For example, even if the body
+ code is specified to throw no exception using <code class="computeroutput">throw
+ () { ... }</code>, the
+ execution of the library code automatically generated by the macros could
+ still throw (if there is no memory, etc).
+ </td></tr>
+</table></div>
+
+ For example:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Variadic Macro Syntax (C99 and later compilers)
+ 
+ </th>
+<th>
+ 
+ Sequencing Macro Syntax (all C++ compilers)
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">#include <boost/local/function.hpp>
+#include <boost/local/block.hpp>
+#include <boost/local/exit.hpp>
+#include <stdexcept>
+#include <algorithm>
+#include <cassert>
+
+int main() {
+ double sum = 0.0;
+ int factor = 10;
+
+ void BOOST_LOCAL_FUNCTION_PARAMS(double num,
+ const bind factor, bind& sum)
+ throw (std::runtime_error, std::logic_error) { // Throw two except.
+ sum += factor * num;
+ } BOOST_LOCAL_FUNCTION_NAME(add)
+ add(100.0);
+
+ size_t size = 2;
+ double* nums = new double[size];
+ BOOST_LOCAL_EXIT(const bind& size, bind nums) throw() { // Throw none.
+ if (size && nums) delete[] nums;
+ } BOOST_LOCAL_EXIT_END
+
+ nums[0] = 90.5; nums[1] = 7.0;
+ std::for_each(nums, nums + size, add);
+
+ BOOST_LOCAL_BLOCK(const bind& sum) throw(std::exception) { // Thow one.
+ assert(sum == 1975.0);
+ } BOOST_LOCAL_BLOCK_END
+
+ return 0;
+}
+</pre>
+
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">#include <boost/local/function.hpp>
+#include <boost/local/block.hpp>
+#include <boost/local/exit.hpp>
+#include <stdexcept>
+#include <algorithm>
+#include <cassert>
+
+int main() {
+ double sum = 0.0;
+ int factor = 10;
+
+ void BOOST_LOCAL_FUNCTION_PARAMS( (double num)
+ (const bind factor) (bind& sum) )
+ throw (std::runtime_error, std::logic_error) { // Throw two except.
+ sum += factor * num;
+ } BOOST_LOCAL_FUNCTION_NAME(add)
+ add(100.0);
+
+ size_t size = 2;
+ double* nums = new double[size];
+ BOOST_LOCAL_EXIT( (const bind& size) (bind nums) ) throw() { // Throw none.
+ if (size && nums) delete[] nums;
+ } BOOST_LOCAL_EXIT_END
+
+ nums[0] = 90.5; nums[1] = 7.0;
+ std::for_each(nums, nums + size, add);
+
+ BOOST_LOCAL_BLOCK( (const bind& sum) ) throw(std::exception) { // Thow one.
+ assert(sum == 1975.0);
+ } BOOST_LOCAL_BLOCK_END
+
+ return 0;
+}
+</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Advanced_Topics.storage_classifiers___auto__and__register__"></a><a class="link" href="Advanced_Topics.html#boost_local.Advanced_Topics.storage_classifiers___auto__and__register__" title="Storage Classifiers (auto and register)">Storage
+ Classifiers (<code class="computeroutput">auto</code> and <code class="computeroutput">register</code>)</a>
+</h3></div></div></div>
+
+ Local function parameters support the storage classifiers as usual in C++.
+ The <code class="computeroutput">auto</code> storage classifier
+ is specified as:
+ 
+<pre class="programlisting">auto parameter-type parameter-name
+</pre>
+
+ and the <code class="computeroutput">register</code> storage classifier
+ is specified as:
+ 
+<pre class="programlisting">register parameter-type parameter-name
+</pre>
+
+ For example:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Variadic Macro Syntax (C99 and later compilers)
+ 
+ </th>
+<th>
+ 
+ Sequencing Macro Syntax (all C++ compilers)
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">#include <boost/local/function.hpp>
+#include <iostream>
+
+int main() {
+ int BOOST_LOCAL_FUNCTION_PARAMS(auto int x, register int y) {
+ return x + y;
+ } BOOST_LOCAL_FUNCTION_NAME(add)
+
+ std::cout << add(3, 5) << std::endl;
+
+ return 0;
+}
+</pre>
+
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">#include <boost/local/function.hpp>
+#include <iostream>
+
+int main() {
+ int BOOST_LOCAL_FUNCTION_PARAMS( (auto int x) (register int y) ) {
+ return x + y;
+ } BOOST_LOCAL_FUNCTION_NAME(add)
+
+ std::cout << add(3, 5) << std::endl;
+
+ return 0;
+}
+</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Advanced_Topics.recursive_local_functions"></a><a class="link" href="Advanced_Topics.html#boost_local.Advanced_Topics.recursive_local_functions" title="Recursive Local Functions">Recursive
+ Local Functions</a>
+</h3></div></div></div>
+
+ A local function can recursively call itself as usual with C++ functions.
+ 
+
+ For example, the following local function is used to recursively calculate
+ and print the factorial of the specified numbers:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Variadic Macro Syntax (C99 and later compilers)
+ 
+ </th>
+<th>
+ 
+ Sequencing Macro Syntax (all C++ compilers)
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">#include <boost/local/function.hpp>
+#include <iostream>
+#include <sstream>
+#include <algorithm>
+#include <vector>
+
+int main () {
+ std::ostringstream output;
+
+ int BOOST_LOCAL_FUNCTION_PARAMS(int n, bool recursion, default false,
+ bind& output) {
+ int result = 0;
+
+ if (n < 2 ) result = 1;
+ else result = n * factorial(n - 1, true); // Recursive call.
+
+ if (!recursion) output << result << " ";
+ return result;
+ } BOOST_LOCAL_FUNCTION_NAME(factorial)
+
+ std::vector<int> v(3);
+ v[0] = 1; v[1] = 4; v[2] = 7;
+ std::for_each(v.begin(), v.end(), factorial);
+
+ std::cout << output.str() << std::endl;
+ return 0;
+}
+</pre>
+
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">#include <boost/local/function.hpp>
+#include <iostream>
+#include <sstream>
+#include <algorithm>
+#include <vector>
+
+int main () {
+ std::ostringstream output;
+
+ int BOOST_LOCAL_FUNCTION_PARAMS( (int n) (bool recursion)(default false)
+ (bind& output) ) {
+ int result = 0;
+
+ if (n < 2 ) result = 1;
+ else result = n * factorial(n - 1, true); // Recursive call.
+
+ if (!recursion) output << result << " ";
+ return result;
+ } BOOST_LOCAL_FUNCTION_NAME(factorial)
+
+ std::vector<int> v(3);
+ v[0] = 1; v[1] = 4; v[2] = 7;
+ std::for_each(v.begin(), v.end(), factorial);
+
+ std::cout << output.str() << std::endl;
+ return 0;
+}
+</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Advanced_Topics.nested_declarations"></a><a class="link" href="Advanced_Topics.html#boost_local.Advanced_Topics.nested_declarations" title="Nested Declarations">Nested
+ Declarations</a>
+</h3></div></div></div>
+
+ It is possible to nest local function, local block, and local exit declarations
+ into one another.
+ 
+
+ For example:
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ Variadic Macro Syntax (C99 and later compilers)
+ 
+ </th>
+<th>
+ 
+ Sequencing Macro Syntax (all C++ compilers)
+ 
+ </th>
+</tr></thead>
+<tbody><tr>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">#include <boost/local/function.hpp>
+#include <boost/local/block.hpp>
+#include <boost/local/exit.hpp>
+#include <iostream>
+#include <cassert>
+
+int main() {
+ int x = 0;
+
+ // Local functions nested into one another.
+ void BOOST_LOCAL_FUNCTION_PARAMS(bind& x) {
+ std::cout << "l: " << x << std::endl;
+
+ void BOOST_LOCAL_FUNCTION_PARAMS(bind& x) {
+ std::cout << "m: " << x << std::endl;
+ } BOOST_LOCAL_FUNCTION_NAME(m)
+
+ x--; m();
+ } BOOST_LOCAL_FUNCTION_NAME(l)
+
+ // Local functions, blocks and exits nested into each other.
+ void BOOST_LOCAL_FUNCTION_PARAMS(bind& x) {
+ BOOST_LOCAL_EXIT(bind& x) {
+ x = 0;
+ BOOST_LOCAL_BLOCK(const bind& x) {
+ assert(x == 0);
+ } BOOST_LOCAL_BLOCK_END
+ } BOOST_LOCAL_EXIT_END
+ std::cout << "n: " << x << std::endl;
+ } BOOST_LOCAL_FUNCTION_NAME(n)
+
+ x--; l();
+ x--; n();
+ return 0;
+}
+</pre>
+
+ 
+ </td>
+<td>
+ 
+
+
+<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting">#include <boost/local/function.hpp>
+#include <boost/local/block.hpp>
+#include <boost/local/exit.hpp>
+#include <iostream>
+#include <cassert>
+
+int main() {
+ int x = 0;
+
+ // Local functions nested into one another.
+ void BOOST_LOCAL_FUNCTION_PARAMS( (bind& x) ) {
+ std::cout << "l: " << x << std::endl;
+
+ void BOOST_LOCAL_FUNCTION_PARAMS( (bind& x) ) {
+ std::cout << "m: " << x << std::endl;
+ } BOOST_LOCAL_FUNCTION_NAME(m)
+
+ x--; m();
+ } BOOST_LOCAL_FUNCTION_NAME(l)
+
+ // Local functions, blocks and exits nested into each other.
+ void BOOST_LOCAL_FUNCTION_PARAMS( (bind& x) ) {
+ BOOST_LOCAL_EXIT( (bind& x) ) {
+ x = 0;
+ BOOST_LOCAL_BLOCK( (const bind& x) ) {
+ assert(x == 0);
+ } BOOST_LOCAL_BLOCK_END
+ } BOOST_LOCAL_EXIT_END
+ std::cout << "n: " << x << std::endl;
+ } BOOST_LOCAL_FUNCTION_NAME(n)
+
+ x--; l();
+ x--; n();
+ return 0;
+}
+</pre>
+
+ 
+ </td>
+</tr></tbody>
+</table></div>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Advanced_Topics.limitations__overloading__operators__etc_"></a><a class="link" href="Advanced_Topics.html#boost_local.Advanced_Topics.limitations__overloading__operators__etc_" title="Limitations (overloading, operators, etc)">Limitations
+ (overloading, operators, etc)</a>
+</h3></div></div></div>
+
+ The following table summarizes all the usual C++ function features that are
+ not supported for local functions.
+ 
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ 
+ C++ Function Feature
+ 
+ </th>
+<th>
+ 
+ Local Function Support
+ 
+ </th>
+<th>
+ 
+ Reason
+ 
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ 
+ <code class="computeroutput">export</code>
+ 
+ </td>
+<td>
+ 
+ No
+ 
+ </td>
+<td>
+ 
+ This is not supported because local functions cannot be templates
+ (plus most C++ compilers do not implement <code class="computeroutput">export</code>).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">template<</code>template-parameter-list<code class="computeroutput">></code>
+ 
+ </td>
+<td>
+ 
+ No
+ 
+ </td>
+<td>
+ 
+ This is not supported because local functions are implemented using
+ local classes and C++ local classes cannot be templates.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">explicit</code>
+ 
+ </td>
+<td>
+ 
+ No
+ 
+ </td>
+<td>
+ 
+ This is not supported because local functions are not constructors.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">inline</code>
+ 
+ </td>
+<td>
+ 
+ No
+ 
+ </td>
+<td>
+ 
+ Local functions are always defined together with their declarations
+ so they are always inlined and there is no need to specify them
+ <code class="computeroutput">inline</code>.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">extern</code>
+ 
+ </td>
+<td>
+ 
+ No
+ 
+ </td>
+<td>
+ 
+ This is not supported because local functions are always defined
+ locally within the enclosing scope and together with their declarations.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">static</code>
+ 
+ </td>
+<td>
+ 
+ No
+ 
+ </td>
+<td>
+ 
+ This is not supported because local functions are not member functions.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="computeroutput">virtual</code>
+ 
+ </td>
+<td>
+ 
+ No
+ 
+ </td>
+<td>
+ 
+ This is not supported because local functions are not member functions.
+ 
+ 
+ In theory, it would be possible for a local functor class to inherit
+ from another local functor class. The parenthesized syntax could
+ be extended to specify the eventual base local functor class within
+ the parenthesized signature (e.g., using <code class="computeroutput">...
+ (extends)(</code>base<code class="computeroutput">)</code>). However, this "inheritance"
+ feature is not implemented because it seems of <a href="http://lists.boost.org/Archives/boost/2010/09/170895.php" target="_top">no
+ use</a> given that local functions can be bound to one another
+ thus they can simply call each other directly without recurring
+ to dynamic binding or base function call.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="literal">result-type</code>
+ 
+ </td>
+<td>
+ 
+ Yes
+ 
+ </td>
+<td>
+ 
+ This is supported (see the <a class="link" href="Tutorial.html" title="Tutorial">Tutorial</a>
+ section).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="literal">function-name</code>
+ 
+ </td>
+<td>
+ 
+ Yes
+ 
+ </td>
+<td>
+ 
+ This is supported but it cannot be overloaded and it cannot be
+ an operator (see the <a class="link" href="Tutorial.html" title="Tutorial">Tutorial</a>
+ and <a class="link" href="Advanced_Topics.html" title="Advanced Topics">Advanced Topics</a>
+ sections).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ <code class="literal">parameter-list</code>
+ 
+ </td>
+<td>
+ 
+ Yes
+ 
+ </td>
+<td>
+ 
+ This is supported and it also supports the <code class="computeroutput">auto</code>
+ and <code class="computeroutput">register</code> storage
+ classifiers, default parameters, and binding of variables in scope
+ (see the <a class="link" href="Tutorial.html" title="Tutorial">Tutorial</a> and
+ <a class="link" href="Advanced_Topics.html" title="Advanced Topics">Advanced Topics</a>
+ sections).
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ Trailing <code class="computeroutput">const</code> qualifier
+ 
+ </td>
+<td>
+ 
+ No
+ 
+ </td>
+<td>
+ 
+ This is not supported because local functions are not member functions.
+ 
+ </td>
+</tr>
+<tr>
+<td>
+ 
+ Trailing <code class="computeroutput">volatile</code>
+ qualifier
+ 
+ </td>
+<td>
+ 
+ No
+ 
+ </td>
+<td>
+ 
+ This is not supported because local functions are not member functions.
+ 
+ </td>
+</tr>
+</tbody>
+</table></div>
+<a name="boost_local.Advanced_Topics.limitations__overloading__operators__etc_.overloading"></a><h6>
+<a name="id909636"></a>
+ <a class="link" href="Advanced_Topics.html#boost_local.Advanced_Topics.limitations__overloading__operators__etc_.overloading">Overloading</a>
+ </h6>
+
+ It is not possible to overload local functions. Declaring multiple local
+ functions with the same name within the same enclosing scope generates a
+ compile-time error (even if the different declarations specify different
+ parameters). [<a name="id909661" href="#ftn.id909661" class="footnote">18</a>]
+ 
+
+ For example, the following code will not
+ compile:
+ 
+<pre class="programlisting">void f() {
+ void <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>( (const int& i) ) {
+ ...
+ } <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_NAME.html" title="Macro BOOST_LOCAL_FUNCTION_NAME">BOOST_LOCAL_FUNCTION_NAME</a></code>(l)
+
+ void <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>( (const double& d) ) {
+ ...
+ } <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_NAME.html" title="Macro BOOST_LOCAL_FUNCTION_NAME">BOOST_LOCAL_FUNCTION_NAME</a></code>(l) // Error: Cannot overload.
+
+ ...
+}
+</pre>
+<a name="boost_local.Advanced_Topics.limitations__overloading__operators__etc_.operators"></a><h6>
+<a name="id909967"></a>
+ <a class="link" href="Advanced_Topics.html#boost_local.Advanced_Topics.limitations__overloading__operators__etc_.operators">Operators</a>
+ </h6>
+
+ Local functions cannot be operators. Naming a local function <code class="computeroutput">operator...</code>
+ will generate a compile-time error. [<a name="id910004" href="#ftn.id910004" class="footnote">19</a>]
+ 
+
+ For example, the following code will not
+ compile:
+ 
+<pre class="programlisting">void f() {
+ struct point {
+ double x;
+ double y;
+ };
+
+ bool <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>(
+ (const point&)(p) (const point&)(q) ) {
+ return p.x == q.x && p.y == q.y;
+ ) <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_NAME.html" title="Macro BOOST_LOCAL_FUNCTION_NAME">BOOST_LOCAL_FUNCTION_NAME</a></code>(operator==) // Error: Cannot be `operator==`.
+
+ ...
+}
+</pre>
+</div>
+<div class="footnotes">
+ <hr width="100" align="left">
+<div class="footnote">[<a id="ftn.id881890" href="#id881890" class="para">15</a>] 
+ Rationale. This limitation derives from
+ the fact that <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>
+ uses preprocessor token concatenation to inspect the parameter type token
+ to see if the token is a parameter or a bound variable. The C++ preprocessor
+ does not allow to concatenate non-alphanumeric tokens.
+ </div>
+<div class="footnote">[<a id="ftn.id883247" href="#id883247" class="para">16</a>] 
+ Rationale. Using variadic macros,
+ this extra set of parenthesis could be eliminated requiring only the
+ parenthesis to invoke the <code class="computeroutput"><a class="link" href="../BOOST_IDENTITY_TYPE.html" title="Macro BOOST_IDENTITY_TYPE">BOOST_IDENTITY_TYPE</a></code>
+ macro. However, this feature is currently not implemented and the double
+ parenthesis are always needed when invoking this macro.
+ </div>
+<div class="footnote">[<a id="ftn.id884552" href="#id884552" class="para">17</a>] 
+ The authors recognize that the use of the identity macros
+ adds extra parenthesis to the already significant number of parenthesis
+ required by the sequencing macro syntax. However, macro parameters usually
+ do not contain unwrapped commas <code class="computeroutput">,</code>
+ (unless template metaprogramming is being used) so this is usually not
+ a problem.
+ </div>
+<div class="footnote">[<a id="ftn.id909661" href="#id909661" class="para">18</a>] 
+ Rationale. This is because a local function
+ is a functor object declared as a local variable within the enclosing scope.
+ Therefore, declaring two local functions with the same name within the
+ same enclosing scope declares two local variables with the same name within
+ the same scope and that is not allowed in C++.
+ </div>
+<div class="footnote">[<a id="ftn.id910004" href="#id910004" class="para">19</a>] 
+ Rationale. This is the because a local
+ function name must be a valid local variable name (the local variable to
+ hold the local functor object) and operators cannot be used as local variable
+ names.
+ </div>
+</div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2009 -2011 Lorenzo Caminiti
+ Use, modification, and distribution is subject to the Boost Software License,
+ Version 1.0 (see accompanying file LICENSE_1_0.txt or a copy at http://www.boost.org/LICENSE_1_0.txt).
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="Tutorial.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="../reference.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/local/libs/local/doc/html/boost_local/Getting.html
==============================================================================
--- (empty file)
+++ sandbox/local/libs/local/doc/html/boost_local/Getting.html 2011-03-18 17:41:51 EDT (Fri, 18 Mar 2011)
@@ -0,0 +1,243 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Getting Started</title>
+<link rel="stylesheet" href="../../../../../doc/src/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
+<link rel="home" href="../index.html" title="Boost.Local 0.1.1">
+<link rel="up" href="../index.html" title="Boost.Local 0.1.1">
+<link rel="prev" href="../index.html" title="Boost.Local 0.1.1">
+<link rel="next" href="Tutorial.html" title="Tutorial">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../index.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="Tutorial.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="boost_local.Getting"></a><a class="link" href="Getting.html" title="Getting Started">Getting Started</a>
+</h2></div></div></div>
+<div class="toc"><dl>
+<dt>This Documentation</dt>
+<dt><a href="Getting.html#boost_local.Getting.compilers_and_platforms">Compilers
+ and Platforms</a></dt>
+<dt>Installation</dt>
+<dt><a href="Getting.html#boost_local.Getting.compile_time_configuration">Compile-Time
+ Configuration</a></dt>
+</dl></div>
+
+ This section explains how to setup your system to use this library.
+ 
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Getting.this_documentation"></a><a class="link" href="Getting.html#boost_local.Getting.this_documentation" title="This Documentation">This Documentation</a>
+</h3></div></div></div>
+
+ Programmers should be ready to use this library, at least at a basic level,
+ after reading the following sections of this documentation:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ The <a class="link" href="../index.html#boost_local.Introduction" title="Introduction">Introduction</a> section
+ provides an overview on the library and its features.
+ </li>
+<li class="listitem">
+ The _Starting_ section explains
+ how to read this documentation, how to install the library to work with
+ the supported compilers and platforms.
+ </li>
+<li class="listitem">
+ The <a class="link" href="Tutorial.html" title="Tutorial">Tutorial</a> section provides
+ a good explanation of basic usages of the library with extensive examples.
+ </li>
+</ul></div>
+
+ The following sections could be consulted at a later point to gain a more
+ in-depth knowledge of the library features:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ The _Advanced_ section explains
+ advanced usages of the library.
+ </li>
+<li class="listitem">
+ The Reference section is the reference
+ manual of the library public API.
+ </li>
+<li class="listitem">
+ The <a class="link" href="Examples.html" title="Appendix: Examples">Examples</a> section lists
+ the source code of a few additional examples that use this library.
+ </li>
+<li class="listitem">
+ The <a class="link" href="Alternatives.html" title="Appendix: Alternatives">Alternatives</a> section
+ describes alternatives to this library to implement local functions.
+ </li>
+</ul></div>
+
+ The following sections are for reference only:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ The _Releases_ section contains
+ short release notes.
+ </li>
+<li class="listitem">
+ The <a class="link" href="Bibliography.html" title="Bibliography">Bibliography</a> section
+ lists references that were consulted in the design and development of
+ this library.
+ </li>
+<li class="listitem">
+ The <a class="link" href="Acknowledgments.html" title="Acknowledgments">Acknowledgments</a>
+ section attempts to recognize all the people that contributes directly
+ or indirectly to the design and development of this library.
+ </li>
+</ul></div>
+
+ Furthermore, some footnotes are marked by the word "Rationale"
+ because they explain reasons behind decisions made during the design and
+ implementation of this library.
+ 
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Getting.compilers_and_platforms"></a><a class="link" href="Getting.html#boost_local.Getting.compilers_and_platforms" title="Compilers and Platforms">Compilers
+ and Platforms</a>
+</h3></div></div></div>
+
+ The implementation of this library uses preprocessor and template metaprogramming
+ (as supported by Boost.Preprocessor
+ and Boost.MPL),
+ templates with partial specializations and function pointers (to support
+ an interface similar to the one of Boost.Function).
+ As a consequence, this library is fairly demanding on compilers' compliance
+ with the ISO C++ standard. At present, this library has been successfully
+ compiled and tested on the following compilers and platforms:
+ 
+<div class="orderedlist"><ol class="orderedlist" type="1">
+<li class="listitem">
+ GCC 4.2.4 on Ubuntu Linux.
+ </li>
+<li class="listitem">
+ GCC 3.4.4 on Cygwin.
+ </li>
+<li class="listitem">
+ Miscrosoft Visual Studio 8.0 on Windows XP.
+ </li>
+</ol></div>
+
+ This library has not yet been tested on any other compiler or platform.
+ 
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Getting.installation"></a><a class="link" href="Getting.html#boost_local.Getting.installation" title="Installation">Installation</a>
+</h3></div></div></div>
+
+ This library is composed of header files only. Therefore there is no pre-compiled
+ object file which needs to be installed. Programmers can simply instruct
+ the C++ compiler where to find the library header files (<code class="computeroutput">-I</code> option for GCC, <code class="computeroutput">/I</code> option for MSVC, etc) and they can start
+ compiling the code from the <a class="link" href="Examples.html" title="Appendix: Examples">Examples</a>
+ section, the code cut-and-pasted from the examples in this documentation,
+ and their own programs that use this library.
+ 
+
+ This library implementation uses a number of Boost
+ libraries among which: Boost.Preprocessor,
+ Boost.ScopeExit,
+ Boost.Typeof,
+ Boost.TypeTraits,
+ and Boost.MPL.
+ These Boost libraries must be
+ properly installed on your system in order for this library to work.
+ 
+
+ The header files of this library are divided as follow:
+ 
+<pre class="programlisting"><code class="computeroutput"><a class="link" href="../reference.html#header.boost.local.function_hpp" title="Header <boost/local/function.hpp>">boost/local/function.hpp</a></code> local functions
+<code class="computeroutput"><a class="link" href="../reference.html#header.boost.local.block_hpp" title="Header <boost/local/block.hpp>">boost/local/block.hpp</a></code> local blocks
+<code class="computeroutput"><a class="link" href="../reference.html#header.boost.local.exit_hpp" title="Header <boost/local/exit.hpp>">boost/local/exit.hpp</a></code> local exits
+<code class="computeroutput"><a class="link" href="../reference.html#header.boost.local.typeof_hpp" title="Header <boost/local/typeof.hpp>">boost/local/typeof.hpp</a></code> bound variable type deduction
+<code class="computeroutput"><a class="link" href="../reference.html#header.boost.local.function_hpp" title="Header <boost/local/function.hpp>">boost/local/function.hpp</a></code> local functors
+<code class="computeroutput"><a class="link" href="../reference.html#header.boost.local.config_hpp" title="Header <boost/local/config.hpp>">boost/local/config.hpp</a></code> configuration macros
+</pre>
+
+ The following symbols are part of the library private API, they are not documented,
+ and they should not be directly used by programmers: [<a name="id866437" href="#ftn.id866437" class="footnote">2</a>]
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ Any symbol defined by files within the <code class="computeroutput">"boost/local/aux_/"</code>
+ directory (these header files should not be directly included by programmers).
+ </li>
+<li class="listitem">
+ Any symbol prefixed by <code class="computeroutput">BOOST_LOCAL_AUX</code>.
+ </li>
+<li class="listitem">
+ Any symbol within the <code class="computeroutput">boost::local::aux</code>
+ namespace.
+ </li>
+<li class="listitem">
+ Any symbol prefixed by <code class="computeroutput">boost_local_aux</code>
+ (regardless of its namespace).
+ </li>
+</ul></div>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Getting.compile_time_configuration"></a><a class="link" href="Getting.html#boost_local.Getting.compile_time_configuration" title="Compile-Time Configuration">Compile-Time
+ Configuration</a>
+</h3></div></div></div>
+
+ Some of the library behaviour can be changed at compile-time by defining
+ special configuration macros. If a configuration macro
+ is left undefined, the library will use an appropriate default value for
+ it.
+ 
+
+ All configuration macros have names prefixed by <code class="computeroutput">BOOST_LOCAL_CONFIG</code>
+ (see Reference section). It is strongly
+ recommended not to change the library configuration macro definitions unless
+ strictly necessary.
+ 
+</div>
+<div class="footnotes">
+ <hr width="100" align="left">
+<div class="footnote">[<a id="ftn.id866437" href="#id866437" class="para">2</a>] 
+ Rationale. This library concatenates symbols
+ specified by the programmers (e.g., the local function name) with other
+ symbols (e.g., special prefixes or preprocessor line numbers) to make internal
+ symbols with unique names to avoid name clashes. These symbols are separated
+ by the letter "<code class="computeroutput">X</code>"
+ when they are concatenated so they can be read more easily while debugging
+ the library. The underscore character "<code class="computeroutput">_</code>"
+ could not be used instead of the letter "<code class="computeroutput">X</code>"
+ because if the original symbols already contained a leading or trailing
+ underscore, the concatenation would result in a symbol with double underscores
+ "<code class="computeroutput">__</code>" which is
+ reserved by the C++ standard.
+ </div>
+</div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2009 -2011 Lorenzo Caminiti
+ Use, modification, and distribution is subject to the Boost Software License,
+ Version 1.0 (see accompanying file LICENSE_1_0.txt or a copy at http://www.boost.org/LICENSE_1_0.txt).
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../index.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="Tutorial.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/local/libs/local/doc/html/boost_local/Getting_Started.html
==============================================================================
--- (empty file)
+++ sandbox/local/libs/local/doc/html/boost_local/Getting_Started.html 2011-03-18 17:41:51 EDT (Fri, 18 Mar 2011)
@@ -0,0 +1,245 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Getting Started</title>
+<link rel="stylesheet" href="../../../../../doc/src/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
+<link rel="home" href="../index.html" title="Boost.Local 0.1.1">
+<link rel="up" href="../index.html" title="Boost.Local 0.1.1">
+<link rel="prev" href="../index.html" title="Boost.Local 0.1.1">
+<link rel="next" href="Tutorial.html" title="Tutorial">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../index.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="Tutorial.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="boost_local.Getting_Started"></a><a class="link" href="Getting_Started.html" title="Getting Started">Getting Started</a>
+</h2></div></div></div>
+<div class="toc"><dl>
+<dt><a href="Getting_Started.html#boost_local.Getting_Started.this_documentation">This
+ Documentation</a></dt>
+<dt><a href="Getting_Started.html#boost_local.Getting_Started.compilers_and_platforms">Compilers
+ and Platforms</a></dt>
+<dt>Installation</dt>
+<dt><a href="Getting_Started.html#boost_local.Getting_Started.compile_time_configuration">Compile-Time
+ Configuration</a></dt>
+</dl></div>
+
+ This section explains how to setup your system to use this library.
+ 
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Getting_Started.this_documentation"></a><a class="link" href="Getting_Started.html#boost_local.Getting_Started.this_documentation" title="This Documentation">This
+ Documentation</a>
+</h3></div></div></div>
+
+ Programmers should be ready to use this library, at least at a basic level,
+ after reading the following sections of this documentation:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ The <a class="link" href="../index.html#boost_local.Introduction" title="Introduction">Introduction</a> section
+ provides an overview on the library and its features.
+ </li>
+<li class="listitem">
+ The _Starting_ section explains
+ how to read this documentation, how to install the library to work with
+ the supported compilers and platforms.
+ </li>
+<li class="listitem">
+ The <a class="link" href="Tutorial.html" title="Tutorial">Tutorial</a> section provides
+ a good explanation of basic usages of the library with extensive examples.
+ </li>
+</ul></div>
+
+ The following sections could be consulted at a later point to gain a more
+ in-depth knowledge of the library features:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ The _Advanced_ section explains
+ advanced usages of the library.
+ </li>
+<li class="listitem">
+ The Reference section is the reference
+ manual of the library public API.
+ </li>
+<li class="listitem">
+ The <a class="link" href="Examples.html" title="Appendix: Examples">Examples</a> section lists
+ the source code of a few additional examples that use this library.
+ </li>
+<li class="listitem">
+ The <a class="link" href="Alternatives.html" title="Appendix: Alternatives">Alternatives</a> section
+ describes alternatives to this library to implement local functions.
+ </li>
+</ul></div>
+
+ The following sections are for reference only:
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ The _Releases_ section contains
+ short release notes.
+ </li>
+<li class="listitem">
+ The <a class="link" href="Bibliography.html" title="Bibliography">Bibliography</a> section
+ lists references that were consulted in the design and development of
+ this library.
+ </li>
+<li class="listitem">
+ The <a class="link" href="Acknowledgments.html" title="Acknowledgments">Acknowledgments</a>
+ section attempts to recognize all the people that contributes directly
+ or indirectly to the design and development of this library.
+ </li>
+</ul></div>
+
+ Furthermore, some footnotes are marked by the word "Rationale"
+ because they explain reasons behind decisions made during the design and
+ implementation of this library.
+ 
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Getting_Started.compilers_and_platforms"></a><a class="link" href="Getting_Started.html#boost_local.Getting_Started.compilers_and_platforms" title="Compilers and Platforms">Compilers
+ and Platforms</a>
+</h3></div></div></div>
+
+ The implementation of this library uses preprocessor and template metaprogramming
+ (as supported by Boost.Preprocessor
+ and Boost.MPL),
+ templates with partial specializations and function pointers (to support
+ an interface similar to the one of Boost.Function).
+ As a consequence, this library is fairly demanding on compilers' compliance
+ with the ISO C++ standard. At present, this library has been successfully
+ compiled and tested on the following compilers and platforms:
+ 
+<div class="orderedlist"><ol class="orderedlist" type="1">
+<li class="listitem">
+ GCC 4.2.4 on Ubuntu Linux.
+ </li>
+<li class="listitem">
+ GCC 3.4.4 on Cygwin.
+ </li>
+<li class="listitem">
+ Miscrosoft Visual Studio 8.0 on Windows XP.
+ </li>
+</ol></div>
+
+ This library has not yet been tested on any other compiler or platform.
+ 
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Getting_Started.installation"></a><a class="link" href="Getting_Started.html#boost_local.Getting_Started.installation" title="Installation">Installation</a>
+</h3></div></div></div>
+
+ This library is composed of header files only. Therefore there is no pre-compiled
+ object file which needs to be installed. Programmers can simply instruct
+ the C++ compiler where to find the library header files (<code class="computeroutput">-I</code> option for GCC, <code class="computeroutput">/I</code> option for MSVC, etc) and they can start
+ compiling the code from the <a class="link" href="Examples.html" title="Appendix: Examples">Examples</a>
+ section, the code cut-and-pasted from the examples in this documentation,
+ and their own programs that use this library.
+ 
+
+ This library implementation uses a number of Boost
+ libraries among which: Boost.Preprocessor,
+ Boost.ScopeExit,
+ Boost.Typeof,
+ Boost.TypeTraits,
+ and Boost.MPL.
+ These Boost libraries must be
+ properly installed on your system in order for this library to work.
+ 
+
+ The header files of this library are divided as follow:
+ 
+<pre class="programlisting"><code class="computeroutput"><a class="link" href="../reference.html#header.boost.local.function_hpp" title="Header <boost/local/function.hpp>">boost/local/function.hpp</a></code> local functions
+<code class="computeroutput"><a class="link" href="../reference.html#header.boost.local.block_hpp" title="Header <boost/local/block.hpp>">boost/local/block.hpp</a></code> local blocks
+<code class="computeroutput"><a class="link" href="../reference.html#header.boost.local.exit_hpp" title="Header <boost/local/exit.hpp>">boost/local/exit.hpp</a></code> local exits
+<code class="computeroutput"><a class="link" href="../reference.html#header.boost.local.typeof_hpp" title="Header <boost/local/typeof.hpp>">boost/local/typeof.hpp</a></code> bound variable type deduction
+<code class="computeroutput"><a class="link" href="../reference.html#header.boost.local.function_hpp" title="Header <boost/local/function.hpp>">boost/local/function.hpp</a></code> local functors
+<code class="computeroutput"><a class="link" href="../reference.html#header.boost.local.config_hpp" title="Header <boost/local/config.hpp>">boost/local/config.hpp</a></code> configuration macros
+</pre>
+
+ The following symbols are part of the library private API, they are not documented,
+ and they should not be directly used by programmers: [<a name="id866442" href="#ftn.id866442" class="footnote">2</a>]
+ 
+<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<li class="listitem">
+ Any symbol defined by files within the <code class="computeroutput">"boost/local/aux_/"</code>
+ directory (these header files should not be directly included by programmers).
+ </li>
+<li class="listitem">
+ Any symbol prefixed by <code class="computeroutput">BOOST_LOCAL_AUX</code>.
+ </li>
+<li class="listitem">
+ Any symbol within the <code class="computeroutput">boost::local::aux</code>
+ namespace.
+ </li>
+<li class="listitem">
+ Any symbol prefixed by <code class="computeroutput">boost_local_aux</code>
+ (regardless of its namespace).
+ </li>
+</ul></div>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Getting_Started.compile_time_configuration"></a><a class="link" href="Getting_Started.html#boost_local.Getting_Started.compile_time_configuration" title="Compile-Time Configuration">Compile-Time
+ Configuration</a>
+</h3></div></div></div>
+
+ Some of the library behaviour can be changed at compile-time by defining
+ special configuration macros. If a configuration macro
+ is left undefined, the library will use an appropriate default value for
+ it.
+ 
+
+ All configuration macros have names prefixed by <code class="computeroutput">BOOST_LOCAL_CONFIG</code>
+ (see Reference section). It is strongly
+ recommended not to change the library configuration macro definitions unless
+ strictly necessary.
+ 
+</div>
+<div class="footnotes">
+ <hr width="100" align="left">
+<div class="footnote">[<a id="ftn.id866442" href="#id866442" class="para">2</a>] 
+ Rationale. This library concatenates symbols
+ specified by the programmers (e.g., the local function name) with other
+ symbols (e.g., special prefixes or preprocessor line numbers) to make internal
+ symbols with unique names to avoid name clashes. These symbols are separated
+ by the letter "<code class="computeroutput">X</code>"
+ when they are concatenated so they can be read more easily while debugging
+ the library. The underscore character "<code class="computeroutput">_</code>"
+ could not be used instead of the letter "<code class="computeroutput">X</code>"
+ because if the original symbols already contained a leading or trailing
+ underscore, the concatenation would result in a symbol with double underscores
+ "<code class="computeroutput">__</code>" which is
+ reserved by the C++ standard.
+ </div>
+</div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2009 -2011 Lorenzo Caminiti
+ Use, modification, and distribution is subject to the Boost Software License,
+ Version 1.0 (see accompanying file LICENSE_1_0.txt or a copy at http://www.boost.org/LICENSE_1_0.txt).
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../index.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="Tutorial.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/local/libs/local/doc/html/boost_local/Release.html
==============================================================================
--- (empty file)
+++ sandbox/local/libs/local/doc/html/boost_local/Release.html 2011-03-18 17:41:51 EDT (Fri, 18 Mar 2011)
@@ -0,0 +1,95 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Release Notes</title>
+<link rel="stylesheet" href="../../../../../doc/src/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
+<link rel="home" href="../index.html" title="Boost.Local 0.1.1">
+<link rel="up" href="../index.html" title="Boost.Local 0.1.1">
+<link rel="prev" href="Implementation.html" title="Appendix: Implementation">
+<link rel="next" href="Bibliography.html" title="Bibliography">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="Implementation.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="Bibliography.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="boost_local.Release"></a><a class="link" href="Release.html" title="Release Notes">Release Notes</a>
+</h2></div></div></div>
+<div class="toc"><dl>
+<dt>Version 0.1.1</dt>
+<dt>Version 0.1.0</dt>
+<dt>Version 0.0.1</dt>
+<dt>TODO</dt>
+</dl></div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Release.version_0_1_1"></a><a class="link" href="Release.html#boost_local.Release.version_0_1_1" title="Version 0.1.1">Version 0.1.1</a>
+</h3></div></div></div>
+<div class="orderedlist"><ol class="orderedlist" type="1">
+<li class="listitem">
+ Uploaded library source into Boost SVN sandbox.
+ </li>
+<li class="listitem">
+ Fixed prev/next arrows and other minor layouts in documentation.
+ </li>
+<li class="listitem">
+ Added Release section to documentation.
+ </li>
+</ol></div>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Release.version_0_1_0"></a><a class="link" href="Release.html#boost_local.Release.version_0_1_0" title="Version 0.1.0">Version 0.1.0</a>
+</h3></div></div></div>
+<div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem">
+ Shared with Boost for first round of comments.
+ </li></ol></div>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Release.version_0_0_1"></a><a class="link" href="Release.html#boost_local.Release.version_0_0_1" title="Version 0.0.1">Version 0.0.1</a>
+</h3></div></div></div>
+<div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem">
+ Completed development, examples, and documentation.
+ </li></ol></div>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Release.todo"></a><a class="link" href="Release.html#boost_local.Release.todo" title="TODO">TODO</a>
+</h3></div></div></div>
+<div class="orderedlist"><ol class="orderedlist" type="1">
+<li class="listitem">
+ Finish local function parenthesized syntax validation macros.
+ </li>
+<li class="listitem">
+ Add examples to Alternatives section for Local Classes, C++0x lambads,
+ Boost.Lambda, and Boost.Phoenix (ask boosters).
+ </li>
+</ol></div>
+</div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2009 -2011 Lorenzo Caminiti
+ Use, modification, and distribution is subject to the Boost Software License,
+ Version 1.0 (see accompanying file LICENSE_1_0.txt or a copy at http://www.boost.org/LICENSE_1_0.txt).
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="Implementation.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="Bibliography.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/local/libs/local/doc/html/boost_local/Release_Notes.html
==============================================================================
--- (empty file)
+++ sandbox/local/libs/local/doc/html/boost_local/Release_Notes.html 2011-03-18 17:41:51 EDT (Fri, 18 Mar 2011)
@@ -0,0 +1,95 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Release Notes</title>
+<link rel="stylesheet" href="../../../../../doc/src/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
+<link rel="home" href="../index.html" title="Boost.Local 0.1.1">
+<link rel="up" href="../index.html" title="Boost.Local 0.1.1">
+<link rel="prev" href="Implementation.html" title="Appendix: Implementation">
+<link rel="next" href="Bibliography.html" title="Bibliography">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../boost.png"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="Implementation.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="Bibliography.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="boost_local.Release_Notes"></a><a class="link" href="Release_Notes.html" title="Release Notes">Release Notes</a>
+</h2></div></div></div>
+<div class="toc"><dl>
+<dt>Version 0.1.1</dt>
+<dt>Version 0.1.0</dt>
+<dt>Version 0.0.1</dt>
+<dt>TODO</dt>
+</dl></div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Release_Notes.version_0_1_1"></a><a class="link" href="Release_Notes.html#boost_local.Release_Notes.version_0_1_1" title="Version 0.1.1">Version 0.1.1</a>
+</h3></div></div></div>
+<div class="orderedlist"><ol class="orderedlist" type="1">
+<li class="listitem">
+ Uploaded library source into Boost SVN sandbox.
+ </li>
+<li class="listitem">
+ Fixed prev/next arrows and other minor layouts in documentation.
+ </li>
+<li class="listitem">
+ Added Release section to documentation.
+ </li>
+</ol></div>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Release_Notes.version_0_1_0"></a><a class="link" href="Release_Notes.html#boost_local.Release_Notes.version_0_1_0" title="Version 0.1.0">Version 0.1.0</a>
+</h3></div></div></div>
+<div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem">
+ Shared with Boost for first round of comments.
+ </li></ol></div>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Release_Notes.version_0_0_1"></a><a class="link" href="Release_Notes.html#boost_local.Release_Notes.version_0_0_1" title="Version 0.0.1">Version 0.0.1</a>
+</h3></div></div></div>
+<div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem">
+ Completed development, examples, and documentation.
+ </li></ol></div>
+</div>
+<div class="section">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="boost_local.Release_Notes.todo"></a><a class="link" href="Release_Notes.html#boost_local.Release_Notes.todo" title="TODO">TODO</a>
+</h3></div></div></div>
+<div class="orderedlist"><ol class="orderedlist" type="1">
+<li class="listitem">
+ Finish local function parenthesized syntax validation macros.
+ </li>
+<li class="listitem">
+ Add examples to Alternatives section for Local Classes, C++0x lambads,
+ Boost.Lambda, and Boost.Phoenix (ask boosters).
+ </li>
+</ol></div>
+</div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2009 -2011 Lorenzo Caminiti
+ Use, modification, and distribution is subject to the Boost Software License,
+ Version 1.0 (see accompanying file LICENSE_1_0.txt or a copy at http://www.boost.org/LICENSE_1_0.txt).
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="Implementation.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="Bibliography.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Date view	Thread view	Subject view	Author view

Boost-Commit list run by bdawes at acm.org, david.abrahams at rcn.com, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk