Changes between Version 136 and Version 137 of LibrariesUnderConstruction

Timestamp:

Jan 7, 2011, 4:49:31 PM (12 years ago)

Author:

Lorenzo Caminiti

Comment:

Renamed and updated Boost.LocalFunction to Boost.Local.

LibrariesUnderConstruction

@@ -690 +690 @@
 
 ---------------------------------------------------------------------------------------------------
-== Boost.LocalFunction ==
+== Boost.Local ==
  * '''Author(s):''' Lorenzo Caminiti 
- * '''Version:''' 0.0.1
- * '''State:''' Prototype
- * '''Last upload:''' September 08, 2010 
- * '''Links:''' [http://sourceforge.net/projects/dbcpp Download] [http://dbcpp.sourceforge.net Documentation]
- * '''Categories:''' [#Utilities Utilities]
- * '''Description:''' Allow to define local functions like.
+ * '''Version:''' 0.1.0
+ * '''State:''' Review Ready
+ * '''Last upload:''' January 03, 2011
+ * '''Links:''' [http://www.boostpro.com/vault/index.php?&direction=0&order=&directory=Function%20Objects Boost Vault] [http://contractpp.sourceforge.net/boost-local_0_1_0-818/libs/local/doc/html/index.html Documentation]
+ * '''Categories:''' [#FunctionObjectsAndHigher-orderProgramming Function Objects And Higher-order Programming]
+ * '''Description:''' Local functions, local blocks, and local exits.
+
+Local functions are a form of information hiding and are useful for dividing procedural tasks into subtasks which are only meaningful locally, avoiding cluttering other parts of the program with functions, variables, etc unrelated to those parts. Local functions therefore complement other structuring possibilities such as namespaces and classes.
+
+* Local functions can access, or better bind, any of the variables from the enclosing scope. Furthermore, local functions defined within a member function can bind the enclosing object this.
+* The local function body is programmed using the usual C++ syntax.
+* Local functions can be passed as template parameters (so they can be conveniently passed to STL algorithms, etc).
+* However, local functions must be defined within a declarative context (e.g., at a point in the code where local variables can be declared) thus they cannot be defined within an expression.
+
+In addition to local functions, this library also supports the following features:
+
+* Local blocks which define blocks of code that bind variables from the enclosing scope. Local blocks allow programmers to bind variables as constants (constant binding) so to prevent local chunks of code from modifying selected variables.
+* Local exits which define blocks of code that are executed when the enclosing scope is exited (again with support for constant binding and binding of the object this).
 
 ---------------------------------------------------------------------------------------------------