Boost C++ Libraries

...one of the most highly regarded and expertly designed C++ library projects in the world. — Herb Sutter and Andrei Alexandrescu, C++ Coding Standards

This is the documentation for a snapshot of the develop branch, built from commit b5267c6e8a.
PrevUpHomeNext

Appendices

Compatibility

Property tree uses partial class template specialization. There has been no attempt to work around lack of support for this. The library will therefore most probably not work with Visual C++ 7.0 or earlier, or gcc 2.x.

Property tree has been tested (regressions successfully compiled and run) with the following compilers:

Rationale

  1. Why are there 3 versions of get? Couldn't there be just one? The three versions reflect experience gathered during several of years of using property tree in several different applications. During that time I tried hard to come up with one, proper form of the get function, and failed. I know of these three basic patterns of usage:
    • Just get the data and I do not care if it cannot be done. This is used when the programmer is fairly sure that data exists. Or in homework assignments. Or when tomorrow is final deadline for your project.
    • Get the data and revert to default value if it cannot be done. Used when you want to allow omitting the key in question. Implemented by some similar tools (windows INI file access functions).
    • Get the data, but I care more whether you succeeded than I do for the data itself. Used when you want to vary control flow depending on get success/failure. Or to check for presence of a key.

Future Development

Copyright © 2008-2010 Marcin Kalicinski
Copyright © 2010-2013 Sebastian Redl

Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

PrevUpHomeNext