- Boost-users - lists.boost.org

[boostbook] Building Boost documentation
by Edward Diener 17 Nov '07

17 Nov '07

Because I wanted to read documentation on some of the new libraries in the latest Boost SVN repository, which existed only in XML format, it was time to go through the annual rite of attempting to use Doug Gregor's excellent documention of "The Boostbook Documentation Format" in order to setup the documentation system to generate documentation using bjam. Although Mr. Gregor's documentation is extremely good, I have never been completely successful in the past, but I had my fingers crossed in hopeful expectation this time. I am doing this on Windows so I have to set things up manually. 1) I downloaded xsltproc and doxygen successfully, and "installed" them into appropriate directories and, to make things easy for myself, put those directories in my PATH. 2) After making sure I had no .jam file of any kind in my home directory I went to the \tools\build\v2\user-config,jam in the directory in which the latest Boost Subversion resides, and added the line: using xsltproc ; 3) I downloaded the latest XSL stylesheets and Docbook DTD and put them in their own separate directies, "E:\Utilities\docbook-xsl-1.73.2" and "E:\Utilities\docbook-dtd-4.2". 4) I added to my user-config.jam the lines: # BoostBook configuration using boostbook : E:/Utilities/docbook-xsl-1.73.2 : E:/Utilities/docbook-dtd-4.2 ; 5) Now further following instructions to test out my installation so far I went to the \libs\function\doc after copying boostbook.css from the \doc\html directory, and tried the bjam command. My result is: warning: Graph library does not contain optional GraphML reader. note: to enable GraphML support, set EXPAT_INCLUDE and EXPAT_LIBPATH to the note: directories containing the Expat headers and libraries, respectively. warning: skipping optional Message Passing Interface (MPI) library. note: to enable MPI support, add "using mpi ;" to user-config.jam. note: to suppress this message, pass "--without-mpi" to bjam. note: otherwise, you can safely ignore this message. Building Boost.Regex with the optional Unicode/ICU support disabled. Please refer to the Boost.Regex documentation for more information (don't panic: this is a strictly optional feature). E:/Utilities/BoostLibraries/boost_1_34_0/tools/build/v2/tools\boostbook.jam:300: in object(boostbook-generator)(a)326.run warning: rulename $(base-target).depends expands to empty string E:/Utilities/BoostLibraries/boost_1_34_0/tools/build/v2/build\generators.jam:840 : in try-one-generator-really E:/Utilities/BoostLibraries/boost_1_34_0/tools/build/v2/build\generators.jam:902 : in try-one-generator E:/Utilities/BoostLibraries/boost_1_34_0/tools/build/v2/build\generators.jam:111 0: in construct-really E:/Utilities/BoostLibraries/boost_1_34_0/tools/build/v2/build\generators.jam:118 6: in generators.construct E:/Utilities/BoostLibraries/boost_1_34_0/tools/build/v2/build\targets.jam:1398: in construct E:/Utilities/BoostLibraries/boost_1_34_0/tools/build/v2/build\targets.jam:1242: in object(typed-target)(a)327.generate E:/Utilities/BoostLibraries/boost_1_34_0/tools/build/v2/build\targets.jam:765: i n generate-really E:/Utilities/BoostLibraries/boost_1_34_0/tools/build/v2/build\targets.jam:738: i n object(main-target)(a)331.generate E:/Utilities/BoostLibraries/boost_1_34_0/tools/build/v2/build\targets.jam:255: i n object(project-target)(a)325.generate E:/Utilities/BoostLibraries/boost_1_34_0/tools/build/v2\build-system.jam:402: in load E:\Utilities\BoostLibraries\boost_1_34_0\tools\build\v2/kernel\modules.jam:261: in import E:\Utilities\BoostLibraries\boost_1_34_0\tools\build\v2/kernel/bootstrap.jam:132 : in boost-build E:\Programming\Version Control\Subversion\Boost\boost-build.jam:9: in module sco pe E:/Utilities/BoostLibraries/boost_1_34_0/tools/build/v2/tools\boostbook.jam:307: in object(boostbook-generator)(a)326.run warning: rulename $(target[2]).set-path expands to empty string E:/Utilities/BoostLibraries/boost_1_34_0/tools/build/v2/build\generators.jam:840 : in try-one-generator-really E:/Utilities/BoostLibraries/boost_1_34_0/tools/build/v2/build\generators.jam:902 : in try-one-generator E:/Utilities/BoostLibraries/boost_1_34_0/tools/build/v2/build\generators.jam:111 0: in construct-really E:/Utilities/BoostLibraries/boost_1_34_0/tools/build/v2/build\generators.jam:118 6: in generators.construct E:/Utilities/BoostLibraries/boost_1_34_0/tools/build/v2/build\targets.jam:1398: in construct E:/Utilities/BoostLibraries/boost_1_34_0/tools/build/v2/build\targets.jam:1242: in object(typed-target)(a)327.generate E:/Utilities/BoostLibraries/boost_1_34_0/tools/build/v2/build\targets.jam:765: i n generate-really E:/Utilities/BoostLibraries/boost_1_34_0/tools/build/v2/build\targets.jam:738: i n object(main-target)(a)331.generate E:/Utilities/BoostLibraries/boost_1_34_0/tools/build/v2/build\targets.jam:255: i n object(project-target)(a)325.generate E:/Utilities/BoostLibraries/boost_1_34_0/tools/build/v2\build-system.jam:402: in load E:\Utilities\BoostLibraries\boost_1_34_0\tools\build\v2/kernel\modules.jam:261: in import E:\Utilities\BoostLibraries\boost_1_34_0\tools\build\v2/kernel/bootstrap.jam:132 : in boost-build E:\Programming\Version Control\Subversion\Boost\boost-build.jam:9: in module sco pe E:/Utilities/BoostLibraries/boost_1_34_0/tools/build/v2/tools\boostbook.jam:308: in object(boostbook-generator)(a)326.run warning: rulename $(target[2]).depends expands to empty string E:/Utilities/BoostLibraries/boost_1_34_0/tools/build/v2/build\generators.jam:840 : in try-one-generator-really E:/Utilities/BoostLibraries/boost_1_34_0/tools/build/v2/build\generators.jam:902 : in try-one-generator E:/Utilities/BoostLibraries/boost_1_34_0/tools/build/v2/build\generators.jam:111 0: in construct-really E:/Utilities/BoostLibraries/boost_1_34_0/tools/build/v2/build\generators.jam:118 6: in generators.construct E:/Utilities/BoostLibraries/boost_1_34_0/tools/build/v2/build\targets.jam:1398: in construct E:/Utilities/BoostLibraries/boost_1_34_0/tools/build/v2/build\targets.jam:1242: in object(typed-target)(a)327.generate E:/Utilities/BoostLibraries/boost_1_34_0/tools/build/v2/build\targets.jam:765: i n generate-really E:/Utilities/BoostLibraries/boost_1_34_0/tools/build/v2/build\targets.jam:738: i n object(main-target)(a)331.generate E:/Utilities/BoostLibraries/boost_1_34_0/tools/build/v2/build\targets.jam:255: i n object(project-target)(a)325.generate E:/Utilities/BoostLibraries/boost_1_34_0/tools/build/v2\build-system.jam:402: in load E:\Utilities\BoostLibraries\boost_1_34_0\tools\build\v2/kernel\modules.jam:261: in import E:\Utilities\BoostLibraries\boost_1_34_0\tools\build\v2/kernel/bootstrap.jam:132 : in boost-build E:\Programming\Version Control\Subversion\Boost\boost-build.jam:9: in module sco pe warn: Unable to construct ./function-doc ...found 1 target... 6) I have no doubt done something wrong, but I have no idea what. Anybody have any clues ?

1 0

HOW TO: Building flexible structure definitions
by Robert Dailey 17 Nov '07

17 Nov '07

Hi, Right now I'm trying to develop a tricky structure that MAY contain any of the following information: - Vertex coordinates (x,y,z) - Color components (r, g, b) - Texture coordinates (u, v) Basically, I'd end up having a structure that looks like this (with all information included): struct Vertex { float x,y,z; // vertex coordinates unsigned char r, g, b; // color components double u,v; // texture coordinates }; The tricky part is that the user isn't required to create a structure with all of this information. For example, the structure above could be missing texture coordinates, color coordinates, or both (however the vertex coordinates are required since I doubt we care about empty structs)! This is for OpenGL vertex buffers, so in addition to this information we need to be able to specify some information in this structure that tells external classes a little bit more about itself. Note that this information CANNOT modify the size of the Vertex structure and must be compile-time only. For example: struct Vertex { // Information (does not change size). Note that if static const unsigned int vertex_type = GL_FLOAT; // Tells openGL the type of the x,y,z members static const unsigned int color_type = GL_UNSIGNED_CHAR; // Tells openGL the type of the r,g,b members static const unsigned int texture_type = GL_DOUBLE; // Tells openGl the type of the u,v members float x,y,z; // vertex coordinates unsigned char r, g, b; // color components double u,v; // texture coordinates }; But wait! There's more I need! This is the part that I was hoping boost could help me with. I have a class that takes objects of type Vertex (well, at least in this example it does. It takes a template argument. See below). The class needs a way (at runtime) to check of the Vertex object passed in has either color, texture, or vertex data in it. Example: template< typename t_vertex > class VertexBuffer { public: VertexBuffer( const t_vertex& vert ) { // How do I check what information is in vert? } } struct Vertex1 { float x,y,z; // vertex coordinates unsigned char r, g, b; // color components double u,v; // texture coordinates }; // This vertex type has NO color! // How would VertexBuffer tell?!? struct Vertex2 { float x,y,z; // vertex coordinates double u,v; // texture coordinates }; VertexBuffer<Vertex1> vbuffer1; VertexBuffer<Vertex2> vbuffer2; Is there something in boost I can utilize to make the definition of Vertex more flexible and open-ended? Perhaps I can use boost in the VertexBuffer class as well to determine the construct of the template type being passed in? Any and ALL help is appreciated.

2 1

Problems with regex, using 1.34.1 version but asking for 1.31
by Arnau Rebassa 17 Nov '07

17 Nov '07

Hi all, I'm very newbie with boost and regex library. First I downloaded the latest version and compiled it for Visual Studio .NET 2003, the compilation went smooth but when I try to compile a minimal program it says: expressions_regulars fatal error LNK1104: cannot open file 'libboost_regex-vc71-sgd-1_31.lib'. I only have *1_34_1.lib files. Searching a bit more, I found the binary installer, so I removed everything from my manual compilation and installed it. When I try to compile, again the same message. I don't understand anything, any idea? Thanks to all!! -- Arnau _________________________________________________________________ Peek-a-boo FREE Tricks & Treats for You! http://www.reallivemoms.com?ocid=TXT_TAGHM&loc=us

2 1

SORRY, FALSE ALARM ===> boost::type_traits::is_convertible.hpp ....how to assert a type is _not_ convertible?
by jono 17 Nov '07

17 Nov '07

i was misreading the error. it was my mistake. cheers jono''

1 0

boost::type_traits::is_convertible.hpp ....how to assert a type is _not_ convertible?
by jono 17 Nov '07

17 Nov '07

hi all, i've got 2 classes like this.... //================================= struct Symbol : private std::string { public: Symbol(const char *cp):std::string(cp){} ~Symbol(){} }; struct String : private std::string { public: String(const String &s):std::string(s.c_str()){} String(const char *cp):std::string(cp){} ~String(){} }; //================================= // // and i'm trying to compile this.... // //================================= template<BinaryOp op, typename ObjectT> Object binary_op(const ObjectT &arg1, const ObjectT &arg2) { return undefined; } template<BinaryOp op> class BinaryOpVisitor : public boost::static_visitor<Object> { public: template<typename ObjectT, typename ObjectU> Object operator()( const ObjectT &arg0, const ObjectU &arg1) const { bool const y = boost::is_convertible<ObjectT, ObjectU>::value; return undefined; } template<typename ObjectT> Object operator ()(const ObjectT &arg0, const ObjectT &arg1) const { return binary_op<op, ObjectT>(arg0, arg1); } }; //================================= // // but using msvc 7.1 i'm getting the following error... // // s:\lib\boost_1_33_1\boost\type_traits\is_convertible.hpp(202) : // error C2243: 'type cast' : conversion from 'Symbol *__w64 ' to 'const std::basic_string<_Elem,_Traits,_Ax> &' exists, but is inaccessible // // //================================= // is_convertible.hpp(202) is as follows ... BOOST_STATIC_CONSTANT(bool, value = sizeof( _m_check(_m_from) ) == sizeof(::boost::type_traits::yes_type) ); //================================= // // // how do i tell (deceive?) the compiler that the conversion does not exist? cheers, jono poff day-one digital auckland, nz

1 0

[mpl] making an array of sizes given a type list
by Michael Marcin 16 Nov '07

16 Nov '07

Given a MPL Random Access Container (typename Types) I want to make a static const std::size_t array which contains the sizeof each type in Types. How can I do this? Thanks, Michael Marcin

2 2

[regex] character classes when using wide chars
by Tomaž Šolc 16 Nov '07

16 Nov '07

-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Hi Documentation says that when using wide character strings with boost::wregex a character class like [[:alpha:]] depends on the system's implementation of iswalpha() function. My system seems to have a working implementation of iswalpha() function, but [[:alpha:]] still only seems to match ASCII alphabet characters. For example the following code: #define UNICODE #include <boost/regex.h> #include <stdio.h> #include <wctype.h> #include <locale.h> int main() { regex_t r; setlocale(LC_ALL, "en_US.utf8"); regcomp(&r, L"^[[:alpha:]]$", REG_EXTENDED); printf("%d\n", iswalpha(L'A')); printf("%d\n\n", regexec(&r, L"A", 0, NULL, 0)); printf("%d\n", iswalpha(L'\x160')); printf("%d\n\n", regexec(&r, L"\x160", 0, NULL, 0)); printf("%d\n", iswalpha(L'1')); printf("%d\n", regexec(&r, L"1", 0, NULL, 0)); regfree(&r); return 0; } Returns 1 0 1 1 0 1 In the second pair, iswalpha() correctly recognizes Unicode "S WITH CARON" character, however regular expression with [[:alpha:]] doesn't match it. I'm using Debian GNU/Linux with Boost 1.33.1. I also tried a similar program using boost::wregex and std::iswalpha() classes instead of the POSIX interface with the same results. Can anyone give me some advice on what I'm doing wrong here? Thanks Tomaž Šolc -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.6 (Darwin) Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org iD8DBQFHPNZXsAlAlRhL9q8RAlymAKDktxV+FWCTvBEBKwMNfr9yus5rgQCfc3N1 WoCdr+9zgBSEXPORSLAJiUM= =18dB -----END PGP SIGNATURE-----

2 3

[condition] How to wait on multiple mutexes with OR semantics?
by Andrey Tcherepanov 16 Nov '07

16 Nov '07

Hello boosters, Let's say I have a 2 condition variables, and 2 threads that wait on them. I would like to collapse these 2 threads into 1 by making thread wait on *either* of these conditions to lock their mutexes (it is not the same mutex). Is it possible to do, or I better change the logic under the hood? Thank you very much, Andrey

2 1

Boost Review Wizard Report for November 2007
by Ronald Garcia 16 Nov '07

16 Nov '07

============================================== Review Wizard Status Report for November 2007 ============================================== News ==== November 7, 2007 - Exception Library Accepted Announcement: http://lists.boost.org/boost-users/2007/11/31912.php We need experienced review managers. Please take a look at the list of libraries in need of managers and check out their descriptions. In general review managers are active boost participants or library contributors. If you can serve as review manager for any of them, email Ron Garcia or John Phillips, "garcia at cs dot indiana dot edu" and "jphillip at capital dot edu" respectively. A link to this report will be posted to www.boost.org. If you would like us to make any modifications or additions to this report before we do that, please email Ron or John. If you're library author and plan on submitting a library for review in the next 3-6 months, send Ron or John a short description of your library and we'll add it to the Libraries Under Construction below. We know that there are many libraries that are near completion, but we have hard time keeping track all of them. Please keep us informed about your progress. Review Queue ============ * Finite State Machines * Floating Point Utilities * Switch * Property Map (fast-track) * Graph (fast-track) * Forward (fast-track) * Singleton (fast-track) * Factory (fast-track) * Lexer * Thread-Safe Signals * Logging * Flyweight * Unordered Containers -------------------- Finite State Machines --------------------- :Author: Andrey Semashev :Review Manager: Martin Vuille :Download: `Boost Sandbox Vault <http://tinyurl.com/yjozfn>`__ :Description: The Boost.FSM library is an implementation of FSM (stands for Finite State Machine) programming concept. The main goals of the library are: * Simplicity. It should be very simple to create state machines using this library. * Performance. The state machine infrastructure should not be very time and memory-consuming in order to be applicable in more use cases. * Extensibility. A developer may want to add more states to an existing state machine. A developer should also be able to specify additional transitions and events for the machine with minimum modifications to the existing code. Floating Point Utilities ------------------------ :Author: Johan Råde :Review Manager: Need Volunteer :Download: `Boost Sandbox Vault <http://boost-consulting.com/vault/index.php? directory=Math%20-%20Numerics>`__ :Description: The Floating Point Utilities library contains the following: * Floating point number classification functions: fpclassify, isfinite, isinf, isnan, isnormal (Follows TR1) * Sign bit functions: signbit, copysign, changesign (Follows TR1) * Facets that format and parse infinity and NaN according to the C99 standard (These can be used for portable handling of infinity and NaN in text streams). Switch ------ :Author: Steven Watanabe :Review Manager: Need Volunteer :Download: `Boost Sandbox Vault <http://boost-consulting.com/vault/index.php? action=downloadfile&filename=mcs_units_v0.7.1.zip&directory=Units>`__ :Description: The built in C/C++ switch statement is very efficient. Unfortunately, unlike a chained if/else construct there is no easy way to use it when the number of cases depends on a template parameter. The Switch library addresses this issue. Property Map (fast-track) ------------------------- :Author: Andrew Sutton :Review Manager: Jeremy Siek :Download: http://svn.boost.org/svn/boost/sandbox/graph-v2 :Description: A number of additions and modifications to the Property Map Library, including: * A constant-valued property map, useful for naturally unweighted graphs. * A noop-writing property map, useful when you have to provide an argument, but just don't care about the output. * See `ChangeLog <http://svn.boost.org/trac/boost/browser/sandbox/ graph-v2/libs/property_map/ChangeLog>`__ for details. Graph (fast-track) ------------------ :Author: Andrew Sutton :Review Manager: Jeremy Siek :Download: http://svn.boost.org/svn/boost/sandbox/graph-v2 :Description: A number of additions and modifications to the Graph Library, including: * Two new graph classes (undirected and directed) which are intended to make the library more approachable for new developers * A suite of graph measures including degree and closeness centrality, mean geodesic distance, eccentricity, and clustering coefficients. * An algorithm for visiting all cycles in a directed graph (Tiernan's from 1970ish). It works for undirected graphs too, but reports cycles twice (one for each direction). * An algorithm for visiting all the cliques a graph (Bron&Kerbosch). Works for both directed and undirected. * Derived graph measures radius and diameter (from eccentricity) and girth and circumference (from Tiernan), and clique number (from Bron&Kerbosch). * An exterior_property class that helps hides some of the weirdness with exterior properties. * runtime and compile-time tests for the new algorithms. * a substantial amount of documentation * Graph cores, implemented by David Gleich (@Stanford University) * Deterministic graph generators - capable of creating or inducing specific types of graphs over a vertex set (e.g., star graph, wheel graph, prism graph, etc). There are several other specific types that could be added to this, but I haven't had the time just yet. Forward (fast-track) -------------------- :Author: Tobias Schwinger :Review Manager: John Torjo :Download: http://boost-consulting.com/vault/index.php? &direction=0&order=&directory=X-Files :Description: A brute-force solution to the forwarding problem. Singleton (fast-track) ---------------------- :Author: Tobias Schwinger :Review Manager: John Torjo :Download: http://boost-consulting.com/vault/index.php? &direction=0&order=&directory=X-Files :Description: Three thread-safe Singleton templates with an easy-to-use interface. Factory (fast-track) -------------------- :Author: Tobias Schwinger :Review Manager: John Torjo :Download: http://boost-consulting.com/vault/index.php? &direction=0&order=&directory=X-Files :Description: Generic factories. Lexer ----- :Author: Ben Hanson :Review Manager: Need Volunteer :Download: http://boost-consulting.com/vault/index.php? action=downloadfile&filename=boost.lexer.zip&directory=Strings%20-% 20Text%20Processing& :Description: A programmable lexical analyser generator inspired by 'flex'. Like flex, it is programmed by the use of regular expressions and outputs a state machine as a number of DFAs utilising equivalence classes for compression. Thread-Safe Signals ------------------- :Author: Frank Hess :Review Manager: Need Volunteer :Download: http://www.boost-consulting.com/vault/index.php? &direction=0&order=&directory=thread_safe_signals :Description: A thread-safe implementation of Boost.signals that has some interface changes to accommodate thread safety, mostly with respect to automatic connection management. Logging ------- :Author: John Torjo :Review Manager: Need Volunteer :Download: http://torjo.com/log2/ :Description: Used properly, logging is a very powerful tool. Besides aiding debugging/testing, it can also show you how your application is used. The Boost Logging Library allows just for that, supporting a lot of scenarios, ranging from very simple (dumping all to one destination), to very complex (multiple logs, some enabled/some not, levels, etc). It features a very simple and flexible interface, efficient filtering of messages, thread-safety, formatters and destinations, easy manipulation of logs, finding the best logger/filter classes based on your application's needs, you can define your own macros and much more! Flyweight --------- :Author: Joaquín M López Muñoz :Review Manager: Need Volunteer :Download: http://www.boost-consulting.com/vault/index.php? action=downloadfile&filename=flyweight.zip&directory=Patterns :Description: Flyweights are small-sized handle classes granting constant access to shared common data, thus allowing for the management of large amounts of entities within reasonable memory limits. Boost.Flyweight makes it easy to use this common programming idiom by providing the class template flyweight<T>, which acts as a drop-in replacement for const T. Unordered Containers -------------------- :Author: Daniel James :Review Manager: Need Volunteer :Download: http://www.boost-consulting.com/vault/index.php? action=downloadfile&filename=unordered.zip&directory=Containers :Description: An implementation of the unordered containers specified in TR1, with most of the changes from the recent draft standards. Libraries under development =========================== Dataflow -------- :Author: Stjepan Rajko :Description: The Dataflow library provides generic support for data producers, consumers, and connections between the two. It also provides layers for several specific dataflow mechanisms, namely Boost.Signals, VTK data/display pipelines, and plain pointers. The Dataflow library came out of the Signal Network GSoC project, mentored by Doug Gregor. :Status: I am polishing the Dataflow library for submission, and am expecting to add it to the review queue in the next couple of months. I am currently ironing out some faults in the design of the library, filling in missing features, and testing it on / adapting it to different dataflow mechanisms (currently VTK and soon Boost.Iostreams). As soon as I'm pretty sure that things are going the right way, I'll submit this to the review queue while I do the finishing touches. Constrained Value ----------------- :Author: Robert Kawulak :Download: http://rk.go.pl/f/constrained_value.zip http://rk.go.pl/r/constrained_value (Documentation) :Description: The Constrained Value library contains class templates useful for creating constrained objects. The simplest example of a constrained object is hour. The only valid values for an hour within a day are integers from the range [0, 23]. With this library, you can create a variable which behaves exactly like int, but does not allow for assignment of values which do not belong to the allowed range. The library doesn't focus only on constrained objects that hold a value belonging to a specified range (i.e., bounded objects). Virtually any constraint can be imposed using appropriate predicate. You can specify what happens in case of assignment of an invalid value, e.g. an exception may be thrown or the value may be adjusted to meet the constraint criterions. :Status: I'm planning to finish it in 1-2 months. Please let us know of any libraries you are currently developing that you intend to submit for review.

2 1

[filesystem] List all drive letters
by Arno 16 Nov '07

16 Nov '07

Hi all, is it possible to find out all root's (especialy all drive letters) in a windows filesystem with the filesystem library. First I thought that I can navigate with the '..' notation like I see it in the Windows explorer, but that didn't work. Is there a simple possibility to do that with that libray? regards Arno

2 1