|
Boost-Commit : |
Subject: [Boost-commit] svn:boost r74601 - in sandbox/local: boost/local boost/local/aux_/function_macros/code_ boost/utility libs/local/doc/html libs/local/doc/html/boost/local/function libs/local/doc/html/boost_local libs/local/doc/qbk libs/local/example
From: lorcaminiti_at_[hidden]
Date: 2011-09-28 14:23:34
Author: lcaminiti
Date: 2011-09-28 14:23:29 EDT (Wed, 28 Sep 2011)
New Revision: 74601
URL: http://svn.boost.org/trac/boost/changeset/74601
Log:
Wrapped some commas generated by the macro within parenthesis so to make it easier to use these macros within other macros. However, unwrapped commas from initialization list = { ... } (necessary for TPL workaround) and from functor member initializers : ... cannot be wrapped but they always contribute to a total of 2 * n - 1 tokens (token1, token2, ...) separated by unwrapped commas where n is the number of bound variables (I'm not sure in case non-bound parameter are used).
Text files modified:
sandbox/local/boost/local/aux_/function_macros/code_/binding.hpp | 26 +++++++++++++--
sandbox/local/boost/local/aux_/function_macros/code_/functor.hpp | 15 ++++++---
sandbox/local/boost/local/function.hpp | 22 ++++++++-----
sandbox/local/boost/utility/identity.hpp | 2 +
sandbox/local/libs/local/doc/html/BOOST_IDENTITY_TYPE.html | 7 +++
sandbox/local/libs/local/doc/html/BOOST_IDENTITY_VALUE.html | 2
sandbox/local/libs/local/doc/html/BOOST_LOCAL_BLOCK.html | 2
sandbox/local/libs/local/doc/html/BOOST_LOCAL_BLOCK_END.html | 2
sandbox/local/libs/local/doc/html/BOOST_LOCAL_BLOCK_TPL.html | 2
sandbox/local/libs/local/doc/html/BOOST_LOCAL_CONFIG_COMPLIANT.html | 2
sandbox/local/libs/local/doc/html/BOOST_LOCAL_CONFIG_FUNCTION_ARITY_MAX.html | 2
sandbox/local/libs/local/doc/html/BOOST_LOCAL_CONFIG_OVERLOAD_MAX.html | 2
sandbox/local/libs/local/doc/html/BOOST_LOCAL_CONFIG_THIS_PARAM_NAME.html | 2
sandbox/local/libs/local/doc/html/BOOST_LOCAL_EXIT.html | 2
sandbox/local/libs/local/doc/html/BOOST_LOCAL_EXIT_END.html | 2
sandbox/local/libs/local/doc/html/BOOST_LOCAL_EXIT_TPL.html | 2
sandbox/local/libs/local/doc/html/BOOST_LOCAL_FUNCTION_NAME.html | 2
sandbox/local/libs/local/doc/html/BOOST_LOCAL_FUNCTION_PARAMS.html | 2
sandbox/local/libs/local/doc/html/BOOST_LOCAL_FUNCTION_PARAMS_TPL.html | 2
sandbox/local/libs/local/doc/html/BOOST_LOCAL_TYPEOF.html | 2
sandbox/local/libs/local/doc/html/boost/local/function/overload.html | 22 ++++++------
sandbox/local/libs/local/doc/html/boost_local/Advanced_Topics.html | 28 ++++++++--------
sandbox/local/libs/local/doc/html/boost_local/Examples.html | 18 +++++-----
sandbox/local/libs/local/doc/html/boost_local/Getting_Started.html | 4 +-
sandbox/local/libs/local/doc/html/boost_local/Tutorial.html | 64 ++++++++++++++++++++--------------------
sandbox/local/libs/local/doc/html/index.html | 10 +++---
sandbox/local/libs/local/doc/qbk/local.qbk | 2
sandbox/local/libs/local/example/scope_guards_errno_va.cpp | 4 +-
28 files changed, 144 insertions(+), 110 deletions(-)
Modified: sandbox/local/boost/local/aux_/function_macros/code_/binding.hpp
==============================================================================
--- sandbox/local/boost/local/aux_/function_macros/code_/binding.hpp (original)
+++ sandbox/local/boost/local/aux_/function_macros/code_/binding.hpp 2011-09-28 14:23:29 EDT (Wed, 28 Sep 2011)
@@ -12,6 +12,7 @@
#include "../../scope_exit/scope_exit.hpp" // Use this lib's ScopeExit impl.
#include "../../preprocessor/sign/params_any_bind.hpp"
#include "../../preprocessor/sign/param_any_bind.hpp"
+#include "../../../../utility/identity.hpp"
#include <boost/type_traits/remove_reference.hpp>
#include <boost/preprocessor/control/iif.hpp>
#include <boost/preprocessor/control/expr_iif.hpp>
@@ -67,8 +68,21 @@
BOOST_SCOPE_EXIT_AUX_PARAM_DECL(r, id_typename, i, \
BOOST_LOCAL_AUX_PP_SIGN_PARAM_ANY_BIND_WITHOUT_TYPE(bind))
-#define BOOST_LOCAL_AUX_FUNCTION_CODE_BINDING_MEMBER_(r, id, i, bind) \
- BOOST_SCOPE_EXIT_AUX_MEMBER(r, id, i, \
+#define BOOST_LOCAL_AUX_FUNCTION_CODE_BINDING_MEMBER_DECL_( \
+ r, id, typename_keyword, i, var) \
+ typename_keyword \
+ BOOST_IDENTITY_TYPE(( /* must use IDENTITY because of tparam comma */ \
+ boost::scope_exit::aux::member< \
+ BOOST_SCOPE_EXIT_AUX_PARAM_T(id, i, var), \
+ BOOST_SCOPE_EXIT_AUX_TAG(id, i) \
+ > \
+ )) \
+ BOOST_SCOPE_EXIT_AUX_PARAM(id,i,var);
+
+#define BOOST_LOCAL_AUX_FUNCTION_CODE_BINDING_MEMBER_(r, id_typename, i, bind) \
+ BOOST_LOCAL_AUX_FUNCTION_CODE_BINDING_MEMBER_DECL_(r, \
+ BOOST_PP_TUPLE_ELEM(2, 0, id_typename), \
+ BOOST_PP_TUPLE_ELEM(2, 1, id_typename), i, \
BOOST_LOCAL_AUX_PP_SIGN_PARAM_ANY_BIND_WITHOUT_TYPE(bind))
#define BOOST_LOCAL_AUX_FUNCTION_CODE_BINDING_PARAM_INIT_(r, id, i, bind) \
@@ -131,8 +145,12 @@
(id, typename_keyword), all_binds) \
BOOST_PP_LIST_FOR_EACH_I( \
BOOST_LOCAL_AUX_FUNCTION_CODE_BINDING_MEMBER_, \
- id, all_binds) \
- } BOOST_LOCAL_AUX_SYMBOL_PARAMS_LOCAL_VARIABLE_NAME(id) = { \
+ (id, typename_keyword), all_binds) \
+ } BOOST_LOCAL_AUX_SYMBOL_PARAMS_LOCAL_VARIABLE_NAME(id) = \
+ /* NOTE: there is no way to wrap member initializer commas within paren */ \
+ /* so you must handle these commas manually if expanding this macro */ \
+ /* within another macro */ \
+ { \
/* initialize the struct with param values to bind */ \
BOOST_PP_EXPR_IIF(BOOST_PP_LIST_IS_CONS(all_bind_this_types), this) \
BOOST_PP_COMMA_IF(BOOST_PP_BITAND( \
Modified: sandbox/local/boost/local/aux_/function_macros/code_/functor.hpp
==============================================================================
--- sandbox/local/boost/local/aux_/function_macros/code_/functor.hpp (original)
+++ sandbox/local/boost/local/aux_/function_macros/code_/functor.hpp 2011-09-28 14:23:29 EDT (Wed, 28 Sep 2011)
@@ -16,6 +16,7 @@
#include "../../type_traits/add_pointed_const.hpp"
#include "../../function.hpp"
#include "../../../config.hpp"
+#include "../../../../utility/identity.hpp"
#include <boost/detail/preprocessor/keyword/auto.hpp>
#include <boost/detail/preprocessor/keyword/register.hpp>
#include <boost/type_traits/add_const.hpp>
@@ -421,9 +422,10 @@
/* functor type -- this type cannot have ID postfix because it is */ \
/* used the `NAME` macro (this symbol is within functor class so */ \
/* it does not have to have ID postfix) */ \
- typedef ::boost::local::aux::function< \
- BOOST_LOCAL_AUX_SYMBOL_FUNCTION_TYPE, \
- default_count> BOOST_LOCAL_AUX_SYMBOL_FUNCTOR_TYPE; \
+ typedef typename_keyword BOOST_IDENTITY_TYPE(( /* IDEN for tparam , */ \
+ ::boost::local::aux::function< \
+ BOOST_LOCAL_AUX_SYMBOL_FUNCTION_TYPE, default_count \
+ >)) BOOST_LOCAL_AUX_SYMBOL_FUNCTOR_TYPE; \
/* typeof types -- these types are qualified with extra eventual */ \
/* const and/or & if their variables are bound by const and/or & */ \
/* (this is because it is not possible to strip the eventual & */ \
@@ -462,6 +464,9 @@
/* constructor */ \
inline explicit BOOST_LOCAL_AUX_SYMBOL_FUNCTOR_CLASS_NAME(id)( \
void* BOOST_LOCAL_AUX_FUNCTION_CODE_FUNCTOR_BIND_PARAM_) \
+ /* NOTE: there is no way to wrap member initializer commas */ \
+ /* within paren so you must handle these commas manually if */ \
+ /* expanding this macro within another macro */ \
BOOST_LOCAL_AUX_FUNCTION_CODE_FUNCTOR_MEMBER_INITS_(const_binds, \
has_const_bind_this, binds, has_bind_this, id) \
{ /* do nothing */ } \
@@ -499,7 +504,7 @@
BOOST_PP_ENUM( \
/* PP_INC to handle no dflt (EXPAND for MVSC) */ \
BOOST_PP_EXPAND(BOOST_PP_INC(default_count)), \
- BOOST_LOCAL_AUX_FUNCTION_CODE_FUNCTOR_STATIC_CALL_FUNC_PTR_, \
+ BOOST_LOCAL_AUX_FUNCTION_CODE_FUNCTOR_STATIC_CALL_FUNC_PTR_, \
~) \
); \
} \
@@ -593,7 +598,7 @@
) \
) \
BOOST_PP_LIST_FOR_EACH_I( \
- BOOST_LOCAL_AUX_FUNCTION_CODE_FUNCTOR_UNBIND_DECL_WITH_DEFAULT_, \
+ BOOST_LOCAL_AUX_FUNCTION_CODE_FUNCTOR_UNBIND_DECL_WITH_DEFAULT_, \
~, unbinds) \
) /* end body function params */ \
/* const member func so it cannot change obj (reassign member */ \
Modified: sandbox/local/boost/local/function.hpp
==============================================================================
--- sandbox/local/boost/local/function.hpp (original)
+++ sandbox/local/boost/local/function.hpp 2011-09-28 14:23:29 EDT (Wed, 28 Sep 2011)
@@ -23,6 +23,11 @@
// params and nothing `` for no params.
#if defined(BOOST_NO_VARIADIC_MACROS) || defined(BOOST_LOCAL_CONFIG_COMPLIANT)
+/** @cond */
+#define BOOST_LOCAL_FUNCTION_PARAMS_(id, is_template, parameters) \
+ BOOST_LOCAL_AUX_FUNCTION_PARAMS(parameters, id, is_template)
+/** @endcond */
+
/**
* @brief This macro is used to declare the local function parameters.
*
@@ -138,8 +143,7 @@
* @RefMacro{BOOST_LOCAL_CONFIG_COMPLIANT}, Boost.Function.
*/
#define BOOST_LOCAL_FUNCTION_PARAMS(parameters) \
- BOOST_LOCAL_AUX_FUNCTION_PARAMS(parameters, \
- __LINE__, 0 /* no template */)
+ BOOST_LOCAL_FUNCTION_PARAMS_(__LINE__, 0 /* no template */, parameters)
/**
* @brief This macro is the same as @RefMacro{BOOST_LOCAL_FUNCTION_PARAMS} but
@@ -148,22 +152,22 @@
* @See @RefMacro{BOOST_LOCAL_FUNCTION_PARAMS}, @RefSect{Tutorial} section.
*/
#define BOOST_LOCAL_FUNCTION_PARAMS_TPL(parameters) \
- BOOST_LOCAL_AUX_FUNCTION_PARAMS(parameters, \
- __LINE__, 1 /* template */)
+ BOOST_LOCAL_FUNCTION_PARAMS_(__LINE__, 1 /* template */, parameters)
#else // BOOST_NO_VARIADIC_MACROS
#include "aux_/preprocessor/variadic/to_seq.hpp"
-#define BOOST_LOCAL_FUNCTION_PARAMS(...) \
+#define BOOST_LOCAL_FUNCTION_PARAMS_(id, is_template, ...) \
BOOST_LOCAL_AUX_FUNCTION_PARAMS(BOOST_LOCAL_AUX_PP_VARIADIC_TO_SEQ( \
(void) /* for empty seq */, __VA_ARGS__), \
- __LINE__, 0 /* no template */)
+ id, is_template)
+
+#define BOOST_LOCAL_FUNCTION_PARAMS(...) \
+ BOOST_LOCAL_FUNCTION_PARAMS_(__LINE__, 0 /* no template */, __VA_ARGS__)
#define BOOST_LOCAL_FUNCTION_PARAMS_TPL(...) \
- BOOST_LOCAL_AUX_FUNCTION_PARAMS(BOOST_LOCAL_AUX_PP_VARIADIC_TO_SEQ( \
- (void) /* for empty seq */, __VA_ARGS__), \
- __LINE__, 1 /* template */)
+ BOOST_LOCAL_FUNCTION_PARAMS_(__LINE__, 1 /* template */, __VA_ARGS__)
#endif // BOOST_NO_VARIADIC_MACROS
Modified: sandbox/local/boost/utility/identity.hpp
==============================================================================
--- sandbox/local/boost/utility/identity.hpp (original)
+++ sandbox/local/boost/utility/identity.hpp 2011-09-28 14:23:29 EDT (Wed, 28 Sep 2011)
@@ -24,6 +24,7 @@
#include <boost/type_traits/function_traits.hpp>
#include <boost/type_traits/add_reference.hpp>
+/** @cond */
namespace boost { namespace aux {
// Identity for values (compilers should be able to optimize call overhead).
@@ -34,6 +35,7 @@
}
}} // namespace boost::aux
+/** @endcond */
/**
* @brief This macro wraps the specified type expression within extra
Modified: sandbox/local/libs/local/doc/html/BOOST_IDENTITY_TYPE.html
==============================================================================
--- sandbox/local/libs/local/doc/html/BOOST_IDENTITY_TYPE.html (original)
+++ sandbox/local/libs/local/doc/html/BOOST_IDENTITY_TYPE.html 2011-09-28 14:23:29 EDT (Wed, 28 Sep 2011)
@@ -33,9 +33,14 @@
</span>BOOST_IDENTITY_TYPE(parenthesized_type)</pre></div>
<div class="refsect1">
-<a name="id926484"></a><h2>Description</h2>
+<a name="id926449"></a><h2>Description</h2>
<p>This macro expands to an expression that can be passed as a single macro parameter even if it contains commas and that evaluates to the specified type at compile-time (see the <a class="link" href="boost_local/Advanced_Topics.html" title="Advanced Topics"> Advanced Topics</a> section).</p>
<p>For example <code class="computeroutput">BOOST_IDENTITY_TYPE((std::map<int, double>))</code> can be passed as a single macro parameter when instead <code class="computeroutput">std::map<int, double></code> cannot (because <code class="computeroutput">std::map<int, double></code> contains a comma not wrapped by round parenthesis so it will be interpreted as two separate macro parameters by the preprocessor).</p>
+<p>On some compilers (like GCC), using this macro on abstract types (classes with one or more pure virtual functions) generate a compile-time error. This can be worked around by manipulating the type adding and removing a reference to it: </p>
+<pre class="programlisting"> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">remove_reference</span><span class="special"><</span> <span class="identifier">BOOST_IDENTITY_TYPE</span><span class="special">(</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">add_reference</span><span class="special"><</span>
+ <span class="identifier">my_abstract_type</span><span class="special"><</span> <span class="keyword">int</span><span class="special">,</span> <span class="keyword">double</span> <span class="special">></span>
+ <span class="special">></span><span class="special">::</span><span class="identifier">type</span><span class="special">)</span><span class="special">)</span> <span class="special">></span><span class="special">::</span><span class="identifier">type</span>
+</pre>
<p><span class="bold"><strong>Parameters:</strong></span> </p>
<div class="informaltable"><table class="table">
<colgroup>
Modified: sandbox/local/libs/local/doc/html/BOOST_IDENTITY_VALUE.html
==============================================================================
--- sandbox/local/libs/local/doc/html/BOOST_IDENTITY_VALUE.html (original)
+++ sandbox/local/libs/local/doc/html/BOOST_IDENTITY_VALUE.html 2011-09-28 14:23:29 EDT (Wed, 28 Sep 2011)
@@ -33,7 +33,7 @@
</span>BOOST_IDENTITY_VALUE(parenthesized_value)</pre></div>
<div class="refsect1">
-<a name="id926651"></a><h2>Description</h2>
+<a name="id926763"></a><h2>Description</h2>
<p>This macro expands to an expression that can be passed as a single macro parameter even if it contains commas and that evaluates to the specified value at run-time (see the <a class="link" href="boost_local/Advanced_Topics.html" title="Advanced Topics"> Advanced Topics</a> section).</p>
<p>For example <code class="computeroutput">BOOST_IDENTITY_VALUE((key_sizeof<int, double>::value))</code> can be passed as a single macro parameter when instead <code class="computeroutput">key_sizeof<int, double>::value</code> cannot (because <code class="computeroutput">key_sizeof<int, double>::value</code> contains a comma not wrapped by round parenthesis so it will be interpreted as two separate macro parameters by the preprocessor).</p>
<p><span class="bold"><strong>Parameters:</strong></span> </p>
Modified: sandbox/local/libs/local/doc/html/BOOST_LOCAL_BLOCK.html
==============================================================================
--- sandbox/local/libs/local/doc/html/BOOST_LOCAL_BLOCK.html (original)
+++ sandbox/local/libs/local/doc/html/BOOST_LOCAL_BLOCK.html 2011-09-28 14:23:29 EDT (Wed, 28 Sep 2011)
@@ -33,7 +33,7 @@
</span>BOOST_LOCAL_BLOCK(bindings)</pre></div>
<div class="refsect1">
-<a name="id920557"></a><h2>Description</h2>
+<a name="id920522"></a><h2>Description</h2>
<p>This macro must be used within a declarative context, it must be followed by the local block body code and then by the <code class="computeroutput"><a class="link" href="BOOST_LOCAL_BLOCK_END.html" title="Macro BOOST_LOCAL_BLOCK_END">BOOST_LOCAL_BLOCK_END</a></code> macro (see the <a class="link" href="boost_local/Tutorial.html" title="Tutorial">Tutorial</a> section): </p>
<pre class="programlisting"> <span class="special">{</span> <span class="comment">// Some declarative context.</span>
<span class="special">...</span>
Modified: sandbox/local/libs/local/doc/html/BOOST_LOCAL_BLOCK_END.html
==============================================================================
--- sandbox/local/libs/local/doc/html/BOOST_LOCAL_BLOCK_END.html (original)
+++ sandbox/local/libs/local/doc/html/BOOST_LOCAL_BLOCK_END.html 2011-09-28 14:23:29 EDT (Wed, 28 Sep 2011)
@@ -33,7 +33,7 @@
</span>BOOST_LOCAL_BLOCK_END</pre></div>
<div class="refsect1">
-<a name="id921411"></a><h2>Description</h2>
+<a name="id921376"></a><h2>Description</h2>
<p>This macro must follow the local block body code <code class="computeroutput">{ ... }</code> as shown in the <code class="computeroutput"><a class="link" href="BOOST_LOCAL_BLOCK.html" title="Macro BOOST_LOCAL_BLOCK">BOOST_LOCAL_BLOCK</a></code> documentation.</p>
<p><span class="bold"><strong>Note:</strong></span> This macro cannot be used multiple times on the same line because it internally uses the line number <code class="computeroutput">__LINE__</code> to generate unique identifiers.</p>
<p><span class="bold"><strong>See:</strong></span> <code class="computeroutput"><a class="link" href="BOOST_LOCAL_BLOCK.html" title="Macro BOOST_LOCAL_BLOCK">BOOST_LOCAL_BLOCK</a></code>, <a class="link" href="boost_local/Tutorial.html" title="Tutorial">Tutorial</a> section. </p>
Modified: sandbox/local/libs/local/doc/html/BOOST_LOCAL_BLOCK_TPL.html
==============================================================================
--- sandbox/local/libs/local/doc/html/BOOST_LOCAL_BLOCK_TPL.html (original)
+++ sandbox/local/libs/local/doc/html/BOOST_LOCAL_BLOCK_TPL.html 2011-09-28 14:23:29 EDT (Wed, 28 Sep 2011)
@@ -33,7 +33,7 @@
</span>BOOST_LOCAL_BLOCK_TPL(bindings)</pre></div>
<div class="refsect1">
-<a name="id921337"></a><h2>Description</h2>
+<a name="id921302"></a><h2>Description</h2>
<p><span class="bold"><strong>See:</strong></span> <code class="computeroutput"><a class="link" href="BOOST_LOCAL_BLOCK.html" title="Macro BOOST_LOCAL_BLOCK">BOOST_LOCAL_BLOCK</a></code>, <a class="link" href="boost_local/Tutorial.html" title="Tutorial">Tutorial</a> section. </p>
</div>
</div>
Modified: sandbox/local/libs/local/doc/html/BOOST_LOCAL_CONFIG_COMPLIANT.html
==============================================================================
--- sandbox/local/libs/local/doc/html/BOOST_LOCAL_CONFIG_COMPLIANT.html (original)
+++ sandbox/local/libs/local/doc/html/BOOST_LOCAL_CONFIG_COMPLIANT.html 2011-09-28 14:23:29 EDT (Wed, 28 Sep 2011)
@@ -33,7 +33,7 @@
</span>BOOST_LOCAL_CONFIG_COMPLIANT</pre></div>
<div class="refsect1">
-<a name="id921584"></a><h2>Description</h2>
+<a name="id921549"></a><h2>Description</h2>
<p>If programmers leave this configuration macro undefined, its default value is to be left not defined.</p>
<p>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 <span class="emphasis"><em>variadic macro</em></span> and <span class="emphasis"><em>empty macro</em></span> syntaxes which some programmers might find more readable than the <span class="emphasis"><em>sequencing macro</em></span> syntax (see the <a class="link" href="boost_local/Tutorial.html" title="Tutorial">Tutorial</a> section, <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 s
equencing macro syntax is allowed (regardless of whether the compiler supports variadic and empty macros or not).</p>
<p><span class="bold"><strong>Warning:</strong></span> 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), they were first introduced by the C99 standard, they are part of the C++0x standard, but they are not part of the official ISO C++ standard. Empty macro parameters are also supported by the C99 standards and they are part of the C++0x standard, but they are not supported by all modern compilers (for example, they are not supported by MSVC).</p>
Modified: sandbox/local/libs/local/doc/html/BOOST_LOCAL_CONFIG_FUNCTION_ARITY_MAX.html
==============================================================================
--- sandbox/local/libs/local/doc/html/BOOST_LOCAL_CONFIG_FUNCTION_ARITY_MAX.html (original)
+++ sandbox/local/libs/local/doc/html/BOOST_LOCAL_CONFIG_FUNCTION_ARITY_MAX.html 2011-09-28 14:23:29 EDT (Wed, 28 Sep 2011)
@@ -33,7 +33,7 @@
</span>BOOST_LOCAL_CONFIG_FUNCTION_ARITY_MAX</pre></div>
<div class="refsect1">
-<a name="id921789"></a><h2>Description</h2>
+<a name="id921754"></a><h2>Description</h2>
<p>If programmers leave this configuration macro undefined, its default value is <code class="computeroutput">5</code>.</p>
<p>This only applies to the number of local function parameters and not to the number of bound variables in scope (the limit on the number of bound variables is instead the maximum size allowed for a Boost.Preprocessor sequence).</p>
<p><span class="bold"><strong>Warning:</strong></span> Increasing this number will increase compilation time.</p>
Modified: sandbox/local/libs/local/doc/html/BOOST_LOCAL_CONFIG_OVERLOAD_MAX.html
==============================================================================
--- sandbox/local/libs/local/doc/html/BOOST_LOCAL_CONFIG_OVERLOAD_MAX.html (original)
+++ sandbox/local/libs/local/doc/html/BOOST_LOCAL_CONFIG_OVERLOAD_MAX.html 2011-09-28 14:23:29 EDT (Wed, 28 Sep 2011)
@@ -33,7 +33,7 @@
</span>BOOST_LOCAL_CONFIG_OVERLOAD_MAX</pre></div>
<div class="refsect1">
-<a name="id921898"></a><h2>Description</h2>
+<a name="id921863"></a><h2>Description</h2>
<p>If programmers leave this configuration macro undefined, its default value is <code class="computeroutput">6</code>.</p>
<p>This number must be greater or equal than 2 (because at least two function types are needed to define an overloaded call operator) otherwise the library will generate a compile-time error.</p>
<p><span class="bold"><strong>Warning:</strong></span> Increasing this number will increase compilation time when the header file <code class="computeroutput">"boost/local/function/overload.hpp"</code> is included.</p>
Modified: sandbox/local/libs/local/doc/html/BOOST_LOCAL_CONFIG_THIS_PARAM_NAME.html
==============================================================================
--- sandbox/local/libs/local/doc/html/BOOST_LOCAL_CONFIG_THIS_PARAM_NAME.html (original)
+++ sandbox/local/libs/local/doc/html/BOOST_LOCAL_CONFIG_THIS_PARAM_NAME.html 2011-09-28 14:23:29 EDT (Wed, 28 Sep 2011)
@@ -33,7 +33,7 @@
</span>BOOST_LOCAL_CONFIG_THIS_PARAM_NAME</pre></div>
<div class="refsect1">
-<a name="id922010"></a><h2>Description</h2>
+<a name="id921976"></a><h2>Description</h2>
<p>If programmers leave this configuration macro undefined, the default symbol used is <code class="computeroutput">this_</code> (this default symbol follows Boost's conventions to postfix with an underscore symbols that refer to C++ keywords -- the <code class="computeroutput">this</code> keyword in this case).</p>
<p><span class="bold"><strong>Warning:</strong></span> Programmers should not define this macro unless it is absolutely necessary (e.g., to avoid name clashes with another library which cannot be changed). Changing the symbol <code class="computeroutput">this_</code> effectively changes the public API of this library.</p>
<p><span class="bold"><strong>See:</strong></span> <a class="link" href="boost_local/Tutorial.html" title="Tutorial">Tutorial</a> section, <a class="link" href="boost_local/Getting_Started.html" title="Getting Started"> Getting Started</a> section. </p>
Modified: sandbox/local/libs/local/doc/html/BOOST_LOCAL_EXIT.html
==============================================================================
--- sandbox/local/libs/local/doc/html/BOOST_LOCAL_EXIT.html (original)
+++ sandbox/local/libs/local/doc/html/BOOST_LOCAL_EXIT.html 2011-09-28 14:23:29 EDT (Wed, 28 Sep 2011)
@@ -33,7 +33,7 @@
</span>BOOST_LOCAL_EXIT(binding_list)</pre></div>
<div class="refsect1">
-<a name="id922168"></a><h2>Description</h2>
+<a name="id922134"></a><h2>Description</h2>
<p>This macro must be used within a declarative context, it must be followed by the local exit body code and then by the <code class="computeroutput"><a class="link" href="BOOST_LOCAL_EXIT_END.html" title="Macro BOOST_LOCAL_EXIT_END">BOOST_LOCAL_EXIT_END</a></code> macro (see the <a class="link" href="boost_local/Tutorial.html" title="Tutorial">Tutorial</a> section): </p>
<pre class="programlisting"> <span class="special">{</span> <span class="comment">// Some declarative context.</span>
<span class="special">...</span>
Modified: sandbox/local/libs/local/doc/html/BOOST_LOCAL_EXIT_END.html
==============================================================================
--- sandbox/local/libs/local/doc/html/BOOST_LOCAL_EXIT_END.html (original)
+++ sandbox/local/libs/local/doc/html/BOOST_LOCAL_EXIT_END.html 2011-09-28 14:23:29 EDT (Wed, 28 Sep 2011)
@@ -33,7 +33,7 @@
</span>BOOST_LOCAL_EXIT_END</pre></div>
<div class="refsect1">
-<a name="id923025"></a><h2>Description</h2>
+<a name="id922990"></a><h2>Description</h2>
<p>This macro must follow the local exit body code <code class="computeroutput">{ ... }</code> as shown in the <code class="computeroutput"><a class="link" href="BOOST_LOCAL_EXIT.html" title="Macro BOOST_LOCAL_EXIT">BOOST_LOCAL_EXIT</a></code> documentation.</p>
<p><span class="bold"><strong>Note:</strong></span> This macro cannot be used multiple times on the same line because it internally uses the line number <code class="computeroutput">__LINE__</code> to generate unique identifiers.</p>
<p><span class="bold"><strong>See:</strong></span> <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/Tutorial.html" title="Tutorial">Tutorial</a> section. </p>
Modified: sandbox/local/libs/local/doc/html/BOOST_LOCAL_EXIT_TPL.html
==============================================================================
--- sandbox/local/libs/local/doc/html/BOOST_LOCAL_EXIT_TPL.html (original)
+++ sandbox/local/libs/local/doc/html/BOOST_LOCAL_EXIT_TPL.html 2011-09-28 14:23:29 EDT (Wed, 28 Sep 2011)
@@ -33,7 +33,7 @@
</span>BOOST_LOCAL_EXIT_TPL(binding_list)</pre></div>
<div class="refsect1">
-<a name="id922951"></a><h2>Description</h2>
+<a name="id922916"></a><h2>Description</h2>
<p><span class="bold"><strong>See:</strong></span> <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/Tutorial.html" title="Tutorial">Tutorial</a> section. </p>
</div>
</div>
Modified: sandbox/local/libs/local/doc/html/BOOST_LOCAL_FUNCTION_NAME.html
==============================================================================
--- sandbox/local/libs/local/doc/html/BOOST_LOCAL_FUNCTION_NAME.html (original)
+++ sandbox/local/libs/local/doc/html/BOOST_LOCAL_FUNCTION_NAME.html 2011-09-28 14:23:29 EDT (Wed, 28 Sep 2011)
@@ -33,7 +33,7 @@
</span>BOOST_LOCAL_FUNCTION_NAME(name)</pre></div>
<div class="refsect1">
-<a name="id924420"></a><h2>Description</h2>
+<a name="id924386"></a><h2>Description</h2>
<p>This macro must follow the local function body code block <code class="computeroutput">{ ... }</code> as shown in the <code class="computeroutput"><a class="link" href="BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code> documentation.</p>
<p>The local function name can be prefixed by the "keyword" <code class="computeroutput">inline</code> (see the <a class="link" href="boost_local/Advanced_Topics.html" title="Advanced Topics"> Advanced Topics</a> section): </p>
<pre class="programlisting"> <span class="special">...</span> <span class="identifier">BOOST_LOCAL_FUNCTION_NAME</span><span class="special">(</span><span class="keyword">inline</span> <span class="identifier">name</span><span class="special">)</span>
Modified: sandbox/local/libs/local/doc/html/BOOST_LOCAL_FUNCTION_PARAMS.html
==============================================================================
--- sandbox/local/libs/local/doc/html/BOOST_LOCAL_FUNCTION_PARAMS.html (original)
+++ sandbox/local/libs/local/doc/html/BOOST_LOCAL_FUNCTION_PARAMS.html 2011-09-28 14:23:29 EDT (Wed, 28 Sep 2011)
@@ -33,7 +33,7 @@
</span>BOOST_LOCAL_FUNCTION_PARAMS(parameters)</pre></div>
<div class="refsect1">
-<a name="id923192"></a><h2>Description</h2>
+<a name="id923157"></a><h2>Description</h2>
<p>This macro must be used within a declarative context, it must follow the local function result type, it must be followed by the local function body code and then by the <code class="computeroutput"><a class="link" href="BOOST_LOCAL_FUNCTION_NAME.html" title="Macro BOOST_LOCAL_FUNCTION_NAME">BOOST_LOCAL_FUNCTION_NAME</a></code> macro (see the <a class="link" href="boost_local/Tutorial.html" title="Tutorial">Tutorial</a> and <a class="link" href="boost_local/Advanced_Topics.html" title="Advanced Topics"> Advanced Topics</a> sections): </p>
<pre class="programlisting"> <span class="special">{</span> <span class="comment">// Some declarative context.</span>
<span class="special">...</span>
Modified: sandbox/local/libs/local/doc/html/BOOST_LOCAL_FUNCTION_PARAMS_TPL.html
==============================================================================
--- sandbox/local/libs/local/doc/html/BOOST_LOCAL_FUNCTION_PARAMS_TPL.html (original)
+++ sandbox/local/libs/local/doc/html/BOOST_LOCAL_FUNCTION_PARAMS_TPL.html 2011-09-28 14:23:29 EDT (Wed, 28 Sep 2011)
@@ -33,7 +33,7 @@
</span>BOOST_LOCAL_FUNCTION_PARAMS_TPL(parameters)</pre></div>
<div class="refsect1">
-<a name="id924346"></a><h2>Description</h2>
+<a name="id924310"></a><h2>Description</h2>
<p><span class="bold"><strong>See:</strong></span> <code class="computeroutput"><a class="link" href="BOOST_LOCAL_FUNCTION_PARAMS.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS">BOOST_LOCAL_FUNCTION_PARAMS</a></code>, <a class="link" href="boost_local/Tutorial.html" title="Tutorial">Tutorial</a> section. </p>
</div>
</div>
Modified: sandbox/local/libs/local/doc/html/BOOST_LOCAL_TYPEOF.html
==============================================================================
--- sandbox/local/libs/local/doc/html/BOOST_LOCAL_TYPEOF.html (original)
+++ sandbox/local/libs/local/doc/html/BOOST_LOCAL_TYPEOF.html 2011-09-28 14:23:29 EDT (Wed, 28 Sep 2011)
@@ -33,7 +33,7 @@
</span>BOOST_LOCAL_TYPEOF(bound_variable_name)</pre></div>
<div class="refsect1">
-<a name="id926162"></a><h2>Description</h2>
+<a name="id926127"></a><h2>Description</h2>
<p>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">t</code> of type <code class="computeroutput">T</code> is: </p>
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem"><p>Bound by value using <code class="computeroutput">bind t</code> then <code class="computeroutput">BOOST_LOCAL_TYPEOF(t)</code> is <code class="computeroutput">T</code>. </p></li>
Modified: sandbox/local/libs/local/doc/html/boost/local/function/overload.html
==============================================================================
--- sandbox/local/libs/local/doc/html/boost/local/function/overload.html (original)
+++ sandbox/local/libs/local/doc/html/boost/local/function/overload.html 2011-09-28 14:23:29 EDT (Wed, 28 Sep 2011)
@@ -35,37 +35,37 @@
<span class="keyword">class</span> <a class="link" href="overload.html" title="Class template overload">overload</a> <span class="special">{</span>
<span class="keyword">public</span><span class="special">:</span>
<span class="comment">// <a class="link" href="overload.html#boost.local.function.overloadconstruct-copy-destruct">construct/copy/destruct</a></span>
- <a class="link" href="overload.html#id435557-bb"><span class="identifier">overload</span></a><span class="special">(</span><span class="keyword">const</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">function</span><span class="special"><</span> <span class="identifier">F0</span> <span class="special">></span> <span class="special">&</span><span class="special">,</span> <span class="keyword">const</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">function</span><span class="special"><</span> <span class="identifier">F1</span> <span class="special">></span> <span class="special">&</span><span class="special">,</span> <span class="special">...</span><span class="special">)</span><span class="special">;</span>
+ <a class="link" href="overload.html#id435338-bb"><span class="identifier">overload</span></a><span class="special">(</span><span class="keyword">const</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">function</span><span class="special"><</span> <span class="identifier">F0</span> <span class="special">></span> <span class="special">&</span><span class="special">,</span> <span class="keyword">const</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">function</span><span class="special"><</span> <span class="identifier">F1</span> <span class="special">></span> <span class="special">&</span><span class="special">,</span> <span class="special">...</span><span class="special">)</span><span class="special">;</span>
- <span class="comment">// <a class="link" href="overload.html#id435478-bb">public member functions</a></span>
- <span class="identifier">result_type</span><span class="special"><</span> <span class="identifier">F0</span> <span class="special">></span> <a class="link" href="overload.html#id435482-bb"><span class="keyword">operator</span><span class="special">(</span><span class="special">)</span></a><span class="special">(</span><span class="identifier">arg0_type</span><span class="special"><</span> <span class="identifier">F0</span> <span class="special">></span><span class="special">,</span> <span class="identifier">arg1_type</span><span class="special"><</span> <span class="identifier">F0</span> <span class="special">></span><span class="special">,</span> <span class="special">...</span><span class="special">)</span> <span class="keyword">const</span><span class="special">;</span>
- <span class="identifier">result_type</span><span class="special"><</span> <span class="identifier">F1</span> <span class="special">></span> <a class="link" href="overload.html#id435520-bb"><span class="keyword">operator</span><span class="special">(</span><span class="special">)</span></a><span class="special">(</span><span class="identifier">arg0_type</span><span class="special"><</span> <span class="identifier">F1</span> <span class="special">></span><span class="special">,</span> <span class="identifier">arg1_type</span><span class="special"><</span> <span class="identifier">F1</span> <span class="special">></span><span class="special">,</span> <span class="special">...</span><span class="special">)</span> <span class="keyword">const</span><span class="special">;</span>
+ <span class="comment">// <a class="link" href="overload.html#id435259-bb">public member functions</a></span>
+ <span class="identifier">result_type</span><span class="special"><</span> <span class="identifier">F0</span> <span class="special">></span> <a class="link" href="overload.html#id435263-bb"><span class="keyword">operator</span><span class="special">(</span><span class="special">)</span></a><span class="special">(</span><span class="identifier">arg0_type</span><span class="special"><</span> <span class="identifier">F0</span> <span class="special">></span><span class="special">,</span> <span class="identifier">arg1_type</span><span class="special"><</span> <span class="identifier">F0</span> <span class="special">></span><span class="special">,</span> <span class="special">...</span><span class="special">)</span> <span class="keyword">const</span><span class="special">;</span>
+ <span class="identifier">result_type</span><span class="special"><</span> <span class="identifier">F1</span> <span class="special">></span> <a class="link" href="overload.html#id435300-bb"><span class="keyword">operator</span><span class="special">(</span><span class="special">)</span></a><span class="special">(</span><span class="identifier">arg0_type</span><span class="special"><</span> <span class="identifier">F1</span> <span class="special">></span><span class="special">,</span> <span class="identifier">arg1_type</span><span class="special"><</span> <span class="identifier">F1</span> <span class="special">></span><span class="special">,</span> <span class="special">...</span><span class="special">)</span> <span class="keyword">const</span><span class="special">;</span>
<span class="special">}</span><span class="special">;</span></pre></div>
<div class="refsect1">
-<a name="id925459"></a><h2>Description</h2>
+<a name="id925425"></a><h2>Description</h2>
<p>This functor aggregates together calls to functions of all the specified function types <code class="computeroutput">F0</code>, <code class="computeroutput">F1</code>, etc. Each function type must be specified following the Boost.Function preferred syntax: </p>
<pre class="programlisting"> <span class="identifier">ResultType</span> <span class="special">(</span><span class="identifier">ArgumentType0</span><span class="special">,</span> <span class="identifier">ArgumgnetType1</span><span class="special">,</span> <span class="special">...</span><span class="special">)</span>
</pre>
<p>The maximum number of overloaded function types is specified by the <code class="computeroutput"><a class="link" href="../../../BOOST_LOCAL_CONFIG_OVERLOAD_MAX.html" title="Macro BOOST_LOCAL_CONFIG_OVERLOAD_MAX">BOOST_LOCAL_CONFIG_OVERLOAD_MAX</a></code> configuration macro. The maximum number of function parameters for each of the specified function type is specified by the <code class="computeroutput"><a class="link" href="../../../BOOST_LOCAL_CONFIG_OVERLOAD_MAX.html" title="Macro BOOST_LOCAL_CONFIG_OVERLOAD_MAX">BOOST_LOCAL_CONFIG_OVERLOAD_MAX</a></code> configuration macro.</p>
<p><span class="bold"><strong>See:</strong></span> <a class="link" href="../../../boost_local/Advanced_Topics.html" title="Advanced Topics"> Advanced Topics</a> section, <code class="computeroutput"><a class="link" href="../../../BOOST_LOCAL_CONFIG_OVERLOAD_MAX.html" title="Macro BOOST_LOCAL_CONFIG_OVERLOAD_MAX">BOOST_LOCAL_CONFIG_OVERLOAD_MAX</a></code>, <code class="computeroutput"><a class="link" href="../../../BOOST_LOCAL_CONFIG_OVERLOAD_MAX.html" title="Macro BOOST_LOCAL_CONFIG_OVERLOAD_MAX">BOOST_LOCAL_CONFIG_OVERLOAD_MAX</a></code>, Boost.Function. </p>
<div class="refsect2">
-<a name="id925603"></a><h3>
+<a name="id925568"></a><h3>
<a name="boost.local.function.overloadconstruct-copy-destruct"></a><code class="computeroutput">overload</code>
public
construct/copy/destruct</h3>
<div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem">
-<pre class="literallayout"><a name="id435557-bb"></a><span class="identifier">overload</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">function</span><span class="special"><</span> <span class="identifier">F0</span> <span class="special">></span> <span class="special">&</span><span class="special">,</span> <span class="keyword">const</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">function</span><span class="special"><</span> <span class="identifier">F1</span> <span class="special">></span> <span class="special">&</span><span class="special">,</span> <span class="special">...</span><span class="special">)</span><span class="special">;</span></pre>Construct the overloading functor. <p>Any functor that can be converted to a <code class="computeroutput">boost::function</code> funcotr can be specified (local functions, functio
n pointers, other functors, etc). </p>
+<pre class="literallayout"><a name="id435338-bb"></a><span class="identifier">overload</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">function</span><span class="special"><</span> <span class="identifier">F0</span> <span class="special">></span> <span class="special">&</span><span class="special">,</span> <span class="keyword">const</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">function</span><span class="special"><</span> <span class="identifier">F1</span> <span class="special">></span> <span class="special">&</span><span class="special">,</span> <span class="special">...</span><span class="special">)</span><span class="special">;</span></pre>Construct the overloading functor. <p>Any functor that can be converted to a <code class="computeroutput">boost::function</code> funcotr can be specified (local functions, functio
n pointers, other functors, etc). </p>
</li></ol></div>
</div>
<div class="refsect2">
-<a name="id925779"></a><h3>
-<a name="id435478-bb"></a><code class="computeroutput">overload</code> public member functions</h3>
+<a name="id925744"></a><h3>
+<a name="id435259-bb"></a><code class="computeroutput">overload</code> public member functions</h3>
<div class="orderedlist"><ol class="orderedlist" type="1">
<li class="listitem">
-<pre class="literallayout"><span class="identifier">result_type</span><span class="special"><</span> <span class="identifier">F0</span> <span class="special">></span> <a name="id435482-bb"></a><span class="keyword">operator</span><span class="special">(</span><span class="special">)</span><span class="special">(</span><span class="identifier">arg0_type</span><span class="special"><</span> <span class="identifier">F0</span> <span class="special">></span><span class="special">,</span> <span class="identifier">arg1_type</span><span class="special"><</span> <span class="identifier">F0</span> <span class="special">></span><span class="special">,</span> <span class="special">...</span><span class="special">)</span> <span class="keyword">const</span><span class="special">;</span></pre>Call operator matching the signature of the function type specified as first. <p>This will in turn invoke the call operator of the first functor that was passed to the constructor. </p>
+<pre class="literallayout"><span class="identifier">result_type</span><span class="special"><</span> <span class="identifier">F0</span> <span class="special">></span> <a name="id435263-bb"></a><span class="keyword">operator</span><span class="special">(</span><span class="special">)</span><span class="special">(</span><span class="identifier">arg0_type</span><span class="special"><</span> <span class="identifier">F0</span> <span class="special">></span><span class="special">,</span> <span class="identifier">arg1_type</span><span class="special"><</span> <span class="identifier">F0</span> <span class="special">></span><span class="special">,</span> <span class="special">...</span><span class="special">)</span> <span class="keyword">const</span><span class="special">;</span></pre>Call operator matching the signature of the function type specified as first. <p>This will in turn invoke the call operator of the first functor that was passed to the constructor. </p>
</li>
<li class="listitem">
-<pre class="literallayout"><span class="identifier">result_type</span><span class="special"><</span> <span class="identifier">F1</span> <span class="special">></span> <a name="id435520-bb"></a><span class="keyword">operator</span><span class="special">(</span><span class="special">)</span><span class="special">(</span><span class="identifier">arg0_type</span><span class="special"><</span> <span class="identifier">F1</span> <span class="special">></span><span class="special">,</span> <span class="identifier">arg1_type</span><span class="special"><</span> <span class="identifier">F1</span> <span class="special">></span><span class="special">,</span> <span class="special">...</span><span class="special">)</span> <span class="keyword">const</span><span class="special">;</span></pre>Call operator matching the signature of the function type specified as second. <p>This will in turn invoke the call operator of the second functor that was passed to the constructor. </p>
+<pre class="literallayout"><span class="identifier">result_type</span><span class="special"><</span> <span class="identifier">F1</span> <span class="special">></span> <a name="id435300-bb"></a><span class="keyword">operator</span><span class="special">(</span><span class="special">)</span><span class="special">(</span><span class="identifier">arg0_type</span><span class="special"><</span> <span class="identifier">F1</span> <span class="special">></span><span class="special">,</span> <span class="identifier">arg1_type</span><span class="special"><</span> <span class="identifier">F1</span> <span class="special">></span><span class="special">,</span> <span class="special">...</span><span class="special">)</span> <span class="keyword">const</span><span class="special">;</span></pre>Call operator matching the signature of the function type specified as second. <p>This will in turn invoke the call operator of the second functor that was passed to the constructor. </p>
</li>
</ol></div>
</div>
Modified: sandbox/local/libs/local/doc/html/boost_local/Advanced_Topics.html
==============================================================================
--- sandbox/local/libs/local/doc/html/boost_local/Advanced_Topics.html (original)
+++ sandbox/local/libs/local/doc/html/boost_local/Advanced_Topics.html 2011-09-28 14:23:29 EDT (Wed, 28 Sep 2011)
@@ -86,7 +86,7 @@
<p>
In addition, local function parameter types cannot start with non-alphanumeric
symbols (alphanumeric symbols are <code class="computeroutput"><span class="identifier">A</span><span class="special">-</span><span class="identifier">Z</span></code>, <code class="computeroutput"><span class="identifier">a</span><span class="special">-</span><span class="identifier">z</span></code>,
- and <code class="computeroutput"><span class="number">0</span><span class="special">-</span><span class="number">9</span></code>). <sup>[<a name="id882473" href="#ftn.id882473" class="footnote">19</a>]</sup> The library will generate (cryptic) preprocessor errors if a
+ and <code class="computeroutput"><span class="number">0</span><span class="special">-</span><span class="number">9</span></code>). <sup>[<a name="id882451" href="#ftn.id882451" class="footnote">19</a>]</sup> The library will generate (cryptic) preprocessor errors if a
parameter type starts with a non-alphanumeric symbol.
</p>
<p>
@@ -225,7 +225,7 @@
<li class="listitem">
Parenthesis to wrap the type expression (and therefore any commas <code class="computeroutput"><span class="special">,</span></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. <sup>[<a name="id883910" href="#ftn.id883910" class="footnote">20</a>]</sup>
+ macro. <sup>[<a name="id883887" href="#ftn.id883887" class="footnote">20</a>]</sup>
</li>
</ol></div>
<div class="note"><table border="0" summary="Note">
@@ -1358,7 +1358,7 @@
the <a class="link" href="Alternatives.html" title="Appendix: Alternatives">Alternatives</a> section).
However, inlined local functions have the limitation that they cannot be
assigned to other functors (like <code class="computeroutput">boost::function</code>)
- and they cannot be passed as template parameters. <sup>[<a name="id904523" href="#ftn.id904523" class="footnote">21</a>]</sup> On C++0x compilers, <code class="computeroutput"><span class="keyword">inline</span></code>
+ and they cannot be passed as template parameters. <sup>[<a name="id904499" href="#ftn.id904499" class="footnote">21</a>]</sup> On C++0x compilers, <code class="computeroutput"><span class="keyword">inline</span></code>
has no effect because this library will automatically generate code that
uses C++0x specific features to inline the local function calls whenever
possible even if the local function is not declared inlined (unless the
@@ -1800,7 +1800,7 @@
functor can be constructed from any function type that can be converted to
a <code class="computeroutput">boost::function</code>
type (i.e., local functions but also function pointers and other function
- objects). <sup>[<a name="id913419" href="#ftn.id913419" class="footnote">22</a>]</sup> The <code class="computeroutput"><a class="link" href="../boost/local/function/overload.html" title="Class template overload">boost::local::function::overload</a></code>
+ objects). <sup>[<a name="id913385" href="#ftn.id913385" class="footnote">22</a>]</sup> The <code class="computeroutput"><a class="link" href="../boost/local/function/overload.html" title="Class template overload">boost::local::function::overload</a></code>
functor provides overloaded call operators <code class="computeroutput"><span class="keyword">operator</span><span class="special">()</span></code> that match the signatures of all the specified
function types.
</p>
@@ -2080,7 +2080,7 @@
<p>
Local function parameters support the storage classifiers as usual in ISO
C++. The <code class="computeroutput"><span class="keyword">auto</span></code> storage classifier
- is specified as: <sup>[<a name="id918033" href="#ftn.id918033" class="footnote">23</a>]</sup>
+ is specified as: <sup>[<a name="id917998" href="#ftn.id917998" class="footnote">23</a>]</sup>
</p>
<pre class="programlisting"><span class="keyword">auto</span> <span class="emphasis"><em>parameter-type parameter-name</em></span>
</pre>
@@ -2310,7 +2310,7 @@
<td>
<p>
This is not supported because local functions are not member functions.
- <sup>[<a name="id919284" href="#ftn.id919284" class="footnote">a</a>]</sup>
+ <sup>[<a name="id919249" href="#ftn.id919249" class="footnote">a</a>]</sup>
</p>
</td>
</tr>
@@ -2409,7 +2409,7 @@
</td>
</tr>
</tbody>
-<tbody class="footnotes"><tr><td colspan="3"><div class="footnote"><p><sup>[<a id="ftn.id919284" href="#id919284" class="para">a</a>] </sup>
+<tbody class="footnotes"><tr><td colspan="3"><div class="footnote"><p><sup>[<a id="ftn.id919249" href="#id919249" class="para">a</a>] </sup>
<span class="bold"><strong>Rationale.</strong></span> It would be possible
to make a local function class inherit from another local function
class. However, this "inheritance" feature is not implemented
@@ -2425,7 +2425,7 @@
</h6>
<p>
Local functions cannot be operators. Naming a local function <code class="computeroutput"><span class="keyword">operator</span><span class="special">...</span></code>
- will generate a compile-time error. <sup>[<a name="id919630" href="#ftn.id919630" class="footnote">24</a>]</sup>
+ will generate a compile-time error. <sup>[<a name="id919596" href="#ftn.id919596" class="footnote">24</a>]</sup>
</p>
<p>
For example, the following code will <span class="bold"><strong>not</strong></span>
@@ -2477,21 +2477,21 @@
</div>
<div class="footnotes">
<br><hr width="100" align="left">
-<div class="footnote"><p><sup>[<a id="ftn.id882473" href="#id882473" class="para">19</a>] </sup>
+<div class="footnote"><p><sup>[<a id="ftn.id882451" href="#id882451" class="para">19</a>] </sup>
<span class="bold"><strong>Rationale.</strong></span> 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.
</p></div>
-<div class="footnote"><p><sup>[<a id="ftn.id883910" href="#id883910" class="para">20</a>] </sup>
+<div class="footnote"><p><sup>[<a id="ftn.id883887" href="#id883887" class="para">20</a>] </sup>
<span class="bold"><strong>Rationale.</strong></span> 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.
</p></div>
-<div class="footnote"><p><sup>[<a id="ftn.id904523" href="#id904523" class="para">21</a>] </sup>
+<div class="footnote"><p><sup>[<a id="ftn.id904499" href="#id904499" class="para">21</a>] </sup>
<span class="bold"><strong>Rationale.</strong></span> This library uses an indirect
function call via a function pointer in order to pass the local function
as a template parameter (see the <a class="link" href="Implementation.html" title="Appendix: Implementation">Implementation</a>
@@ -2505,7 +2505,7 @@
be inlined on C++0x compilers (even when the local function is not declared
inlined).
</p></div>
-<div class="footnote"><p><sup>[<a id="ftn.id913419" href="#id913419" class="para">22</a>] </sup>
+<div class="footnote"><p><sup>[<a id="ftn.id913385" href="#id913385" class="para">22</a>] </sup>
The <code class="computeroutput"><a class="link" href="../boost/local/function/overload.html" title="Class template overload">boost::local::function::overload</a></code>
functor can aggregate any functor and it is not at all specific to local
functions. Therefore, it might be preferable to move <code class="computeroutput"><a class="link" href="../boost/local/function/overload.html" title="Class template overload">boost::local::function::overload</a></code>
@@ -2513,7 +2513,7 @@
to Boost.Function
and to rename it as <code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">function</span><span class="special">::</span><span class="identifier">overload</span></code>.
</p></div>
-<div class="footnote"><p><sup>[<a id="ftn.id918033" href="#id918033" class="para">23</a>] </sup>
+<div class="footnote"><p><sup>[<a id="ftn.id917998" href="#id917998" class="para">23</a>] </sup>
The <code class="computeroutput"><span class="keyword">auto</span></code> storage classifier
is part of the ISO C++ standard and therefore supported by this library.
However, the meaning and usage of the <code class="computeroutput"><span class="keyword">auto</span></code>
@@ -2521,7 +2521,7 @@
storage classifier with the usual care in order to avoid writing ISO C++
code that might not work on C++0x.
</p></div>
-<div class="footnote"><p><sup>[<a id="ftn.id919630" href="#id919630" class="para">24</a>] </sup>
+<div class="footnote"><p><sup>[<a id="ftn.id919596" href="#id919596" class="para">24</a>] </sup>
<span class="bold"><strong>Rationale.</strong></span> This is the because a local
function name must be a valid local variable name (the local variable to
hold the local functor) and operators cannot be used as local variable
Modified: sandbox/local/libs/local/doc/html/boost_local/Examples.html
==============================================================================
--- sandbox/local/libs/local/doc/html/boost_local/Examples.html (original)
+++ sandbox/local/libs/local/doc/html/boost_local/Examples.html 2011-09-28 14:23:29 EDT (Wed, 28 Sep 2011)
@@ -330,15 +330,15 @@
<span class="identifier">BOOST_LOCAL_EXIT</span><span class="special">(</span><span class="keyword">void</span><span class="special">)</span> <span class="special">{</span> <span class="comment">// Same as D's `scope(exit)`.</span>
<span class="identifier">std</span><span class="special">::</span><span class="identifier">cout</span> <span class="special"><<</span> <span class="string">"exit"</span> <span class="special"><<</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">endl</span><span class="special">;</span>
<span class="special">}</span> <span class="identifier">BOOST_LOCAL_EXIT_END</span>
-
- <span class="identifier">BOOST_LOCAL_EXIT</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">bind</span><span class="special">&</span> <span class="identifier">error</span><span class="special">)</span> <span class="special">{</span> <span class="comment">// Sane as D's `scope(success)`.</span>
- <span class="keyword">if</span> <span class="special">(!</span><span class="identifier">error</span><span class="special">)</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">cout</span> <span class="special"><<</span> <span class="string">"success"</span> <span class="special"><<</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">endl</span><span class="special">;</span>
- <span class="special">}</span> <span class="identifier">BOOST_LOCAL_EXIT_END</span>
-
- <span class="identifier">BOOST_LOCAL_EXIT</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">bind</span><span class="special">&</span> <span class="identifier">error</span><span class="special">)</span> <span class="special">{</span> <span class="comment">// Same as D's `scope(failure)`.</span>
- <span class="keyword">if</span> <span class="special">(</span><span class="identifier">error</span><span class="special">)</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">cout</span> <span class="special"><<</span> <span class="string">"failure"</span> <span class="special"><<</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">endl</span><span class="special">;</span>
- <span class="special">}</span> <span class="identifier">BOOST_LOCAL_EXIT_END</span>
-
+<span class="comment">/*
+ BOOST_LOCAL_EXIT(const bind& error) { // Sane as D's `scope(success)`.
+ if (!error) std::cout << "success" << std::endl;
+ } BOOST_LOCAL_EXIT_END
+
+ BOOST_LOCAL_EXIT(const bind& error) { // Same as D's `scope(failure)`.
+ if (error) std::cout << "failure" << std::endl;
+ } BOOST_LOCAL_EXIT_END
+*/</span>
<span class="keyword">return</span> <span class="identifier">error</span> <span class="special">=</span> <span class="special">-</span><span class="number">1</span><span class="special">;</span> <span class="comment">// Must set error.</span>
<span class="special">}</span>
Modified: sandbox/local/libs/local/doc/html/boost_local/Getting_Started.html
==============================================================================
--- sandbox/local/libs/local/doc/html/boost_local/Getting_Started.html (original)
+++ sandbox/local/libs/local/doc/html/boost_local/Getting_Started.html 2011-09-28 14:23:29 EDT (Wed, 28 Sep 2011)
@@ -123,7 +123,7 @@
</pre>
<p>
The followings are part of the library private API, they are not documented,
- and they should not be directly used by programmers: <sup>[<a name="id866236" href="#ftn.id866236" class="footnote">2</a>]</sup>
+ and they should not be directly used by programmers: <sup>[<a name="id866215" href="#ftn.id866215" class="footnote">2</a>]</sup>
</p>
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
@@ -161,7 +161,7 @@
</div>
<div class="footnotes">
<br><hr width="100" align="left">
-<div class="footnote"><p><sup>[<a id="ftn.id866236" href="#id866236" class="para">2</a>] </sup>
+<div class="footnote"><p><sup>[<a id="ftn.id866215" href="#id866215" class="para">2</a>] </sup>
<span class="bold"><strong>Rationale.</strong></span> 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
Modified: sandbox/local/libs/local/doc/html/boost_local/Tutorial.html
==============================================================================
--- sandbox/local/libs/local/doc/html/boost_local/Tutorial.html (original)
+++ sandbox/local/libs/local/doc/html/boost_local/Tutorial.html 2011-09-28 14:23:29 EDT (Wed, 28 Sep 2011)
@@ -115,12 +115,12 @@
<span class="special">...</span> <span class="special">}</span></code>
using the usual C++ syntax. The body is specified outside any of the macros
so eventual compiler error messages and related line numbers retain their
- usual meaning and format. <sup>[<a name="id866937" href="#ftn.id866937" class="footnote">3</a>]</sup>
+ usual meaning and format. <sup>[<a name="id866916" href="#ftn.id866916" class="footnote">3</a>]</sup>
</p>
<p>
The macro <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_NAME.html" title="Macro BOOST_LOCAL_FUNCTION_NAME">BOOST_LOCAL_FUNCTION_NAME</a></code>
is used to end the local function definition and to specify the local function
- name. <sup>[<a name="id866973" href="#ftn.id866973" class="footnote">4</a>]</sup>
+ name. <sup>[<a name="id866952" href="#ftn.id866952" class="footnote">4</a>]</sup>
</p>
<p>
For example, let's program a local function named <code class="computeroutput"><span class="identifier">add</span></code>
@@ -376,7 +376,7 @@
This library also allows to specify default values for the local function
parameters. However, the usual C++ syntax for default parameters that uses
the assignment symbol <code class="computeroutput"><span class="special">=</span></code> cannot
- be used. <sup>[<a name="id869085" href="#ftn.id869085" class="footnote">5</a>]</sup> The keyword <code class="computeroutput"><span class="keyword">default</span></code>
+ be used. <sup>[<a name="id869064" href="#ftn.id869064" class="footnote">5</a>]</sup> The keyword <code class="computeroutput"><span class="keyword">default</span></code>
is used instead:
</p>
<div class="informaltable"><table class="table">
@@ -478,7 +478,7 @@
<p>
Programmers can define a <code class="computeroutput"><span class="identifier">WITH_DEFAULT</span></code>
macro similar to the following if they think it improves readability over
- the syntax above: <sup>[<a name="id870060" href="#ftn.id870060" class="footnote">6</a>]</sup>
+ the syntax above: <sup>[<a name="id870041" href="#ftn.id870041" class="footnote">6</a>]</sup>
</p>
<div class="informaltable"><table class="table">
<colgroup>
@@ -552,7 +552,7 @@
variables, the object <code class="computeroutput"><span class="keyword">this</span></code>,
etc) can be bound to a local function declaration. The types of bound variables
are automatically deduced by this library using Boost.Typeof.
- <sup>[<a name="id870862" href="#ftn.id870862" class="footnote">7</a>]</sup>
+ <sup>[<a name="id870842" href="#ftn.id870842" class="footnote">7</a>]</sup>
</p>
<div class="important"><table border="0" summary="Important">
<tr>
@@ -569,7 +569,7 @@
</table></div>
<p>
This library introduces the new "keyword" <code class="computeroutput"><span class="identifier">bind</span></code>
- <sup>[<a name="id870944" href="#ftn.id870944" class="footnote">8</a>]</sup> which is used in place of the parameter type to specify the name
+ <sup>[<a name="id870924" href="#ftn.id870924" class="footnote">8</a>]</sup> which is used in place of the parameter type to specify the name
of a variable in scope to bind. The variable can be bound by value:
</p>
<pre class="programlisting"><span class="identifier">bind</span> <span class="emphasis"><em>variable-name</em></span> <span class="comment">// Bind by value.</span>
@@ -594,7 +594,7 @@
<p>
Note that when <code class="computeroutput"><span class="keyword">const</span></code> is used,
it must always precede <code class="computeroutput"><span class="identifier">bind</span></code>.
- <sup>[<a name="id871171" href="#ftn.id871171" class="footnote">9</a>]</sup>
+ <sup>[<a name="id871152" href="#ftn.id871152" class="footnote">9</a>]</sup>
</p>
<p>
If a variable is bound by value, then a copy of the variable value is taken
@@ -621,7 +621,7 @@
forced using <code class="computeroutput"><span class="keyword">const</span> <span class="identifier">bind</span>
<span class="special">...</span></code>. (Note that binding by constant
reference is not supported by <a href="http://en.wikipedia.org/wiki/C%2B%2B0x#Lambda_functions_and_expressions" target="_top">C++0x
- lambda</a> functions but it is supported by this library.) <sup>[<a name="id871358" href="#ftn.id871358" class="footnote">10</a>]</sup>
+ lambda</a> functions but it is supported by this library.) <sup>[<a name="id871339" href="#ftn.id871339" class="footnote">10</a>]</sup>
</li>
<li class="listitem">
If a bound variable was declared as a reference in the enclosing scope,
@@ -629,7 +629,7 @@
using <code class="computeroutput"><span class="identifier">bind</span><span class="special">&</span>
<span class="special">...</span></code> or <code class="computeroutput"><span class="keyword">const</span>
<span class="identifier">bind</span><span class="special">&</span>
- <span class="special">...</span></code>. <sup>[<a name="id871481" href="#ftn.id871481" class="footnote">11</a>]</sup>
+ <span class="special">...</span></code>. <sup>[<a name="id871462" href="#ftn.id871462" class="footnote">11</a>]</sup>
</li>
</ul></div>
<p>
@@ -723,7 +723,7 @@
when it is in scope (e.g., from an enclosing member function). This is done
by using <code class="computeroutput"><span class="keyword">this</span></code> as the name of
the variable to bind in the local function declaration and by using the special
- symbol <code class="computeroutput"><span class="identifier">this_</span></code> <sup>[<a name="id872651" href="#ftn.id872651" class="footnote">12</a>]</sup> (instead of <code class="computeroutput"><span class="keyword">this</span></code>)
+ symbol <code class="computeroutput"><span class="identifier">this_</span></code> <sup>[<a name="id872632" href="#ftn.id872632" class="footnote">12</a>]</sup> (instead of <code class="computeroutput"><span class="keyword">this</span></code>)
to access the object within the local function body.
</p>
<p>
@@ -766,12 +766,12 @@
<p>
When the object <code class="computeroutput"><span class="keyword">this</span></code> is bound
to a local function, the local function body must use the special symbol
- <code class="computeroutput"><span class="identifier">this_</span></code> (instead of <code class="computeroutput"><span class="keyword">this</span></code>) to access the bound object. <sup>[<a name="id872982" href="#ftn.id872982" class="footnote">13</a>]</sup>
+ <code class="computeroutput"><span class="identifier">this_</span></code> (instead of <code class="computeroutput"><span class="keyword">this</span></code>) to access the bound object. <sup>[<a name="id872961" href="#ftn.id872961" class="footnote">13</a>]</sup>
</p>
<p>
Unfortunately, mistakenly using <code class="computeroutput"><span class="keyword">this</span></code>
within the local function body instead of <code class="computeroutput"><span class="identifier">this_</span></code>
- will not necessarily generate a compile-time error. <sup>[<a name="id873083" href="#ftn.id873083" class="footnote">14</a>]</sup> Programmers are responsible to make sure that <code class="computeroutput"><span class="keyword">this</span></code> is never used within a local function
+ will not necessarily generate a compile-time error. <sup>[<a name="id873062" href="#ftn.id873062" class="footnote">14</a>]</sup> Programmers are responsible to make sure that <code class="computeroutput"><span class="keyword">this</span></code> is never used within a local function
body which should only use the special symbol <code class="computeroutput"><span class="identifier">this_</span></code>.
</p>
</td></tr>
@@ -958,7 +958,7 @@
<tr><td align="left" valign="top"><p>
A <code class="computeroutput"><span class="keyword">return</span><span class="special">;</span></code>
instruction from within a local block jumps to the end of the local block
- body and it does not return the enclosing function. <sup>[<a name="id876495" href="#ftn.id876495" class="footnote">15</a>]</sup>
+ body and it does not return the enclosing function. <sup>[<a name="id876475" href="#ftn.id876475" class="footnote">15</a>]</sup>
</p></td></tr>
</table></div>
<p>
@@ -1070,7 +1070,7 @@
</tr>
<tr><td align="left" valign="top"><p>
The execution of the local exit body code is guaranteed only if the program
- does not terminate because of an uncaught exception. <sup>[<a name="id877734" href="#ftn.id877734" class="footnote">16</a>]</sup>
+ does not terminate because of an uncaught exception. <sup>[<a name="id877714" href="#ftn.id877714" class="footnote">16</a>]</sup>
</p></td></tr>
</table></div>
<p>
@@ -1175,7 +1175,7 @@
Local exits are very similar to the <span class="emphasis"><em>scope exits</em></span> provided
by Boost.ScopeExit
with the addition that they also support constant binding and binding of
- the object <code class="computeroutput"><span class="keyword">this</span></code>. <sup>[<a name="id879016" href="#ftn.id879016" class="footnote">17</a>]</sup> Local exits can be used to emulate the <a href="http://d.digitalmars.com" target="_top">D
+ the object <code class="computeroutput"><span class="keyword">this</span></code>. <sup>[<a name="id878995" href="#ftn.id878995" class="footnote">17</a>]</sup> Local exits can be used to emulate the <a href="http://d.digitalmars.com" target="_top">D
Programming Language</a> <span class="emphasis"><em>scope guards</em></span> (see the
<a class="link" href="Examples.html#boost_local.Examples.Emulating_Ds_Scope_Guards" title="Emulating D's Scope Guards">Emulating
D's Scope Guards</a> example).
@@ -1189,7 +1189,7 @@
When local functions, local blocks, and local exits are programmed within
templates, they need to be declared using the following special macros ending
with the <code class="computeroutput"><span class="identifier">TPL</span></code> postfix (see
- the Reference section): <sup>[<a name="id879329" href="#ftn.id879329" class="footnote">18</a>]</sup>
+ the Reference section): <sup>[<a name="id879307" href="#ftn.id879307" class="footnote">18</a>]</sup>
</p>
<pre class="programlisting"><code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_PARAMS_TPL.html" title="Macro BOOST_LOCAL_FUNCTION_PARAMS_TPL">BOOST_LOCAL_FUNCTION_PARAMS_TPL</a></code><span class="special">(</span><span class="emphasis"><em>parameters</em></span><span class="special">)</span>
<code class="computeroutput"><a class="link" href="../BOOST_LOCAL_BLOCK_TPL.html" title="Macro BOOST_LOCAL_BLOCK_TPL">BOOST_LOCAL_BLOCK_TPL</a></code><span class="special">(</span><span class="emphasis"><em>bindings</em></span><span class="special">)</span>
@@ -1324,20 +1324,20 @@
</div>
<div class="footnotes">
<br><hr width="100" align="left">
-<div class="footnote"><p><sup>[<a id="ftn.id866937" href="#id866937" class="para">3</a>] </sup>
+<div class="footnote"><p><sup>[<a id="ftn.id866916" href="#id866916" class="para">3</a>] </sup>
<span class="bold"><strong>Rationale.</strong></span> If the local function body
were instead passed as a macro parameter, it would be expanded on a single
line of code (because macros always expand as a single line of code). Therefore,
eventual compiler error line numbers would all report the same value and
would no longer be useful to pinpoint the error.
</p></div>
-<div class="footnote"><p><sup>[<a id="ftn.id866973" href="#id866973" class="para">4</a>] </sup>
+<div class="footnote"><p><sup>[<a id="ftn.id866952" href="#id866952" class="para">4</a>] </sup>
<span class="bold"><strong>Rationale.</strong></span> The local function name must
be passed to the macro <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_NAME.html" title="Macro BOOST_LOCAL_FUNCTION_NAME">BOOST_LOCAL_FUNCTION_NAME</a></code>
ending the function definition so this macro can declare a local variable
with the local function name to hold the local function object.
</p></div>
-<div class="footnote"><p><sup>[<a id="ftn.id869085" href="#id869085" class="para">5</a>] </sup>
+<div class="footnote"><p><sup>[<a id="ftn.id869064" href="#id869064" class="para">5</a>] </sup>
<span class="bold"><strong>Rationale.</strong></span> The assignment symbol <code class="computeroutput"><span class="special">=</span></code> cannot be used to specify default parameter
values because default values are not part of the parameter type so they
cannot be handled using template metaprogamming. Default parameter values
@@ -1350,12 +1350,12 @@
symbol cannot be detected by preprocessor metaprogramming because it cannot
be concatenated by the preprocessor).
</p></div>
-<div class="footnote"><p><sup>[<a id="ftn.id870060" href="#id870060" class="para">6</a>] </sup>
+<div class="footnote"><p><sup>[<a id="ftn.id870041" href="#id870041" class="para">6</a>] </sup>
The authors do not personally find the use of the <code class="computeroutput"><span class="identifier">WITH_DEFAULT</span></code>
macro more readable and they prefer to use the <code class="computeroutput"><span class="keyword">default</span></code>
"keyword" directly.
</p></div>
-<div class="footnote"><p><sup>[<a id="ftn.id870862" href="#id870862" class="para">7</a>] </sup>
+<div class="footnote"><p><sup>[<a id="ftn.id870842" href="#id870842" class="para">7</a>] </sup>
<span class="bold"><strong>Rationale.</strong></span> By binding a variable in scope,
the local function declaration is specifying that such a variable should
be accessible within the local function body regardless of its type. Semantically,
@@ -1368,7 +1368,7 @@
For example, this is useful for maintenance because if a bound variable
type is changed, the local function declaration does not have to change.
</p></div>
-<div class="footnote"><p><sup>[<a id="ftn.id870944" href="#id870944" class="para">8</a>] </sup>
+<div class="footnote"><p><sup>[<a id="ftn.id870924" href="#id870924" class="para">8</a>] </sup>
Obviously, the token <code class="computeroutput"><span class="identifier">bind</span></code>
is not a keyword of the C++ language. This library parses the token <code class="computeroutput"><span class="identifier">bind</span></code> during macro expansion using preprocessor
metaprogramming (see the <a class="link" href="Implementation.html" title="Appendix: Implementation">Implementation</a>
@@ -1377,7 +1377,7 @@
level within the syntax defined by the macros of this library -- thus it
is referred to as a "keyword" only within quotes.
</p></div>
-<div class="footnote"><p><sup>[<a id="ftn.id871171" href="#id871171" class="para">9</a>] </sup>
+<div class="footnote"><p><sup>[<a id="ftn.id871152" href="#id871152" class="para">9</a>] </sup>
<span class="bold"><strong>Rationale.</strong></span> The library macros could have
been implemented to accept both syntaxes <code class="computeroutput"><span class="keyword">const</span>
<span class="identifier">bind</span> <span class="special">...</span></code>
@@ -1388,7 +1388,7 @@
<span class="identifier">bind</span> <span class="special">...</span></code>)
is supported.
</p></div>
-<div class="footnote"><p><sup>[<a id="ftn.id871358" href="#id871358" class="para">10</a>] </sup>
+<div class="footnote"><p><sup>[<a id="ftn.id871339" href="#id871339" class="para">10</a>] </sup>
An historical note: Constant binding of variables in scope was the
main use case that originally motivated the authors in developing this
library. The authors needed to locally create a chuck of code to assert
@@ -1403,7 +1403,7 @@
correctly generates an error because the bound variable is of <code class="computeroutput"><span class="keyword">const</span></code> type within the local function
body.
</p></div>
-<div class="footnote"><p><sup>[<a id="ftn.id871481" href="#id871481" class="para">11</a>] </sup>
+<div class="footnote"><p><sup>[<a id="ftn.id871462" href="#id871462" class="para">11</a>] </sup>
<span class="bold"><strong>Rationale.</strong></span> Variables originally declared
as references are bound by value unless <code class="computeroutput"><span class="special">[</span><span class="keyword">const</span><span class="special">]</span> <span class="identifier">bind</span><span class="special">&</span></code>
is used so that references can be bound by both value <code class="computeroutput"><span class="special">[</span><span class="keyword">const</span><span class="special">]</span> <span class="identifier">bind</span></code>
@@ -1416,13 +1416,13 @@
even if <code class="computeroutput"><span class="identifier">bind</span><span class="special">[&]</span></code>
is used instead of <code class="computeroutput"><span class="keyword">const</span> <span class="identifier">bind</span><span class="special">[&]</span></code>.
</p></div>
-<div class="footnote"><p><sup>[<a id="ftn.id872651" href="#id872651" class="para">12</a>] </sup>
+<div class="footnote"><p><sup>[<a id="ftn.id872632" href="#id872632" class="para">12</a>] </sup>
<span class="bold"><strong>Rationale.</strong></span> The special name <code class="computeroutput"><span class="identifier">this_</span></code> was chosen following <a href="http://boost.2283326.n4.nabble.com/local-this-or-this-td3423912.html" target="_top">Boost
practises</a> which postfix with an underscore identifiers that are
named after keywords (the C++ keyword <code class="computeroutput"><span class="keyword">this</span></code>
in this case).
</p></div>
-<div class="footnote"><p><sup>[<a id="ftn.id872982" href="#id872982" class="para">13</a>] </sup>
+<div class="footnote"><p><sup>[<a id="ftn.id872961" href="#id872961" class="para">13</a>] </sup>
<span class="bold"><strong>Rationale.</strong></span> This limitation comes from
the fact that <code class="computeroutput"><span class="keyword">this</span></code> is a
reserved C++ keyword so it cannot be used as the name of the internal
@@ -1436,7 +1436,7 @@
behaviour of <code class="computeroutput"><span class="keyword">static_cast</span></code></a>
(which might not work on all platforms at the cost of portability).
</p></div>
-<div class="footnote"><p><sup>[<a id="ftn.id873083" href="#id873083" class="para">14</a>] </sup>
+<div class="footnote"><p><sup>[<a id="ftn.id873062" href="#id873062" class="para">14</a>] </sup>
<span class="bold"><strong>Rationale.</strong></span> The local function body cannot
be a static member function of the local functor object in order to support
recursion (because the local function name is specified by the <code class="computeroutput"><a class="link" href="../BOOST_LOCAL_FUNCTION_NAME.html" title="Macro BOOST_LOCAL_FUNCTION_NAME">BOOST_LOCAL_FUNCTION_NAME</a></code>
@@ -1449,7 +1449,7 @@
Therefore, from within the local function body the variable <code class="computeroutput"><span class="keyword">this</span></code> is visible but it refers to the local
functor and not to the bound object.
</p></div>
-<div class="footnote"><p><sup>[<a id="ftn.id876495" href="#id876495" class="para">15</a>] </sup>
+<div class="footnote"><p><sup>[<a id="ftn.id876475" href="#id876475" class="para">15</a>] </sup>
<span class="bold"><strong>Rationale.</strong></span> Programmers might expect
<code class="computeroutput"><span class="keyword">return</span><span class="special">;</span></code>
to exit the enclosing function instead of the local block (or local exit),
@@ -1467,7 +1467,7 @@
<code class="computeroutput"><span class="identifier">BOOST_LOCAL_RETURN</span><span class="special">;</span></code>)
to exit local blocks (and local exits).
</p></div>
-<div class="footnote"><p><sup>[<a id="ftn.id877734" href="#id877734" class="para">16</a>] </sup>
+<div class="footnote"><p><sup>[<a id="ftn.id877714" href="#id877714" class="para">16</a>] </sup>
<span class="bold"><strong>Rationale.</strong></span> This library (as well as
<a href="http://www.boost.org/doc/libs/release/libs/scope_exit/doc/html/index.html" target="_top">Boost.ScopeExit</a>)
uses the destructor of a local variable to automatically execute the
@@ -1478,7 +1478,7 @@
scope exit code even if the main program terminates because of an uncaught
exception.)
</p></div>
-<div class="footnote"><p><sup>[<a id="ftn.id879016" href="#id879016" class="para">17</a>] </sup>
+<div class="footnote"><p><sup>[<a id="ftn.id878995" href="#id878995" class="para">17</a>] </sup>
<span class="bold"><strong>Rationale.</strong></span> This library could be merged
together with Boost.ScopeExit
into a new library named Boost.Scope (from the meaning of the word "scope"
@@ -1507,7 +1507,7 @@
name of "<a href="http://gcc.gnu.org/onlinedocs/gcc/Nested-Functions.html" target="_top">nested
functions</a>" (GCC compiler extension).
</p></div>
-<div class="footnote"><p><sup>[<a id="ftn.id879329" href="#id879329" class="para">18</a>] </sup>
+<div class="footnote"><p><sup>[<a id="ftn.id879307" href="#id879307" class="para">18</a>] </sup>
<span class="bold"><strong>Rationale.</strong></span> Within templates, this library
needs to use <code class="computeroutput"><span class="keyword">typename</span></code> to explicitly
indicate that some expressions evaluate to a type. Because C++ does not
Modified: sandbox/local/libs/local/doc/html/index.html
==============================================================================
--- sandbox/local/libs/local/doc/html/index.html (original)
+++ sandbox/local/libs/local/doc/html/index.html 2011-09-28 14:23:29 EDT (Wed, 28 Sep 2011)
@@ -23,11 +23,11 @@
<div><h2 class="title">
<a name="boost_local"></a>Boost.Local 0.2.0 </h2></div>
<div><div class="authorgroup"><div class="author"><h3 class="author">
-<span class="firstname">Lorenzo</span> <span class="surname">Caminiti (lorcaminiti -at- gmail.com)</span>
+<span class="firstname">Lorenzo</span> <span class="surname">Caminiti (lorcaminiti-AT-gmail.com)</span>
</h3></div></div></div>
<div><p class="copyright">Copyright © 2009-2011 Lorenzo Caminiti</p></div>
<div><div class="legalnotice">
-<a name="id810140"></a><p>
+<a name="id808134"></a><p>
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).
</p>
@@ -344,7 +344,7 @@
by reference, by constant value, and by constant reference. In addition,
the object <code class="computeroutput"><span class="keyword">this</span></code> can be bound
(eventually by constant value but never by reference or constant reference
- <sup>[<a name="id865476" href="#ftn.id865476" class="footnote">1</a>]</sup> ) from within a non-static member function (see the <a class="link" href="boost_local/Tutorial.html" title="Tutorial">Tutorial</a>
+ <sup>[<a name="id865454" href="#ftn.id865454" class="footnote">1</a>]</sup> ) from within a non-static member function (see the <a class="link" href="boost_local/Tutorial.html" title="Tutorial">Tutorial</a>
section). For example, the variable <code class="computeroutput"><span class="identifier">factor</span></code>
is bound by constant value so it cannot be mistakenly modified by the local
function body. The variable <code class="computeroutput"><span class="identifier">sum</span></code>
@@ -420,13 +420,13 @@
</div>
<div class="footnotes">
<br><hr width="100" align="left">
-<div class="footnote"><p><sup>[<a id="ftn.id865476" href="#id865476" class="para">1</a>] </sup>
+<div class="footnote"><p><sup>[<a id="ftn.id865454" href="#id865454" class="para">1</a>] </sup>
C++ does not allow to obtain a reference to the pointer <code class="computeroutput"><span class="keyword">this</span></code>.
</p></div>
</div>
</div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
-<td align="left"><p><small>Last revised: May 19, 2011 at 14:42:25 GMT</small></p></td>
+<td align="left"><p><small>Last revised: September 28, 2011 at 18:17:11 GMT</small></p></td>
<td align="right"><div class="copyright-footer"></div></td>
</tr></table>
<hr>
Modified: sandbox/local/libs/local/doc/qbk/local.qbk
==============================================================================
--- sandbox/local/libs/local/doc/qbk/local.qbk (original)
+++ sandbox/local/libs/local/doc/qbk/local.qbk 2011-09-28 14:23:29 EDT (Wed, 28 Sep 2011)
@@ -9,7 +9,7 @@
[version 0.2.0 ]
[/ purpose Local functions, blocks, and exits for C++]
[/ category Function Objects and Higher-Order Programming]
- [authors [Caminiti <lorcaminiti-AT-gmail.com>, Lorenzo]]
+ [authors [Caminiti (lorcaminiti-AT-gmail.com), Lorenzo]]
[copyright 2009-2011 Lorenzo Caminiti]
[license
Use, modification, and distribution is subject to the
Modified: sandbox/local/libs/local/example/scope_guards_errno_va.cpp
==============================================================================
--- sandbox/local/libs/local/example/scope_guards_errno_va.cpp (original)
+++ sandbox/local/libs/local/example/scope_guards_errno_va.cpp 2011-09-28 14:23:29 EDT (Wed, 28 Sep 2011)
@@ -23,7 +23,7 @@
BOOST_LOCAL_EXIT(void) { // Same as D's `scope(exit)`.
std::cout << "exit" << std::endl;
} BOOST_LOCAL_EXIT_END
-
+/*
BOOST_LOCAL_EXIT(const bind& error) { // Sane as D's `scope(success)`.
if (!error) std::cout << "success" << std::endl;
} BOOST_LOCAL_EXIT_END
@@ -31,7 +31,7 @@
BOOST_LOCAL_EXIT(const bind& error) { // Same as D's `scope(failure)`.
if (error) std::cout << "failure" << std::endl;
} BOOST_LOCAL_EXIT_END
-
+*/
return error = -1; // Must set error.
}
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