Quick Start
You are viewing the develop version of this library.
The master and develop pages are shown here to provide access to the newest in-development in-progress documentation. See the "Documentation" link on this page.
Other aspects of the page will reflect the previous official version, or not be available until the next release.
Contributors: This Release
LEAF
A lightweight error handling library for C++11.
Documentation
https://boostorg.github.io/leaf/
Features
- Portable single-header format, no dependencies.
- Tiny code size, configurable for embedded development.
- No dynamic memory allocations, even with very large payloads.
- Deterministic unbiased efficiency on the "happy" path and the "sad" path.
- Error objects are handled in constant time, independent of call stack depth.
- Can be used with or without exception handling.
Support
- cpplang on Slack (use the
#boostchannel) - Boost Users Mailing List
- Boost Developers Mailing List
Distribution
Besides GitHub, there are two other distribution channels:
- LEAF is included in official Boost releases, starting with Boost 1.75.
- For maximum portability, the library is also available in single-header format: leaf.hpp.
Copyright 2018-2025 Emil Dotchevski and Reverge Studios, Inc. Distributed under the http://www.boost.org/LICENSE_1_0.txt[Boost Software License, Version 1.0].
Latest Boost.Leaf posts
<h1>LEAF</h1> <blockquote> <p>A lightweight error handling library for C++11.</p> </blockquote> <h2>Documentation</h2> <p>https://boostorg.github.io/leaf/</p> <h2>Features</h2> <ul> <li>Portable single-header format, no dependencies.</li> <li>Tiny code size, configurable for embedded development.</li> <li>No dynamic memory allocations, even with very large payloads.</li> <li>Deterministic unbiased efficiency on the "happy" path and the "sad" path.</li> <li>Error objects are handled in constant time, independent of call stack depth.</li> <li>Can be used with or without exception handling.</li> </ul> <h2>Support</h2> <ul> <li><a href="https://Cpplang.slack.com">cpplang on Slack</a> (use the <code>#boost</code> channel)</li> <li><a href="https://lists.boost.org/mailman/listinfo.cgi/boost-users">Boost Users Mailing List</a></li> <li><a href="https://lists.boost.org/mailman/listinfo.cgi/boost">Boost Developers Mailing List</a></li> </ul> <h2>Distribution</h2> <p>Besides GitHub, there are two other distribution channels:</p> <ul> <li>LEAF is included in official <a href="https://www.boost.org/">Boost</a> releases, starting with Boost 1.75.</li> <li>For maximum portability, the library is also available in single-header format: <a href="https://raw.githubusercontent.com/boostorg/leaf/gh-pages/leaf.hpp">leaf.hpp</a>.</li> </ul> <p>Copyright 2018-2025 Emil Dotchevski and Reverge Studios, Inc. Distributed under the http://www.boost.org/LICENSE_1_0.txt[Boost Software License, Version 1.0].</p>
-
Code Commits Commits authored to any Boost repository. With 1 contribution, you will earn the bronze badge for Code Commits.
-
Documentation Doc contributions using standardised Boost tooling (Antora / BoostLook). With 1 contribution, you will earn the bronze badge for Documentation.
-
Library Authoring Authored an original Boost library accepted into the collection. With 1 contribution, you will earn the bronze badge for Library Authoring.
-
Library Maintenance Number of libraries actively maintained. With 1 contribution, you will earn the bronze badge for Library Maintenance.
-
Library Review Formal review submissions on Boost proposals. With 1 contribution, you will earn the bronze badge for Library Review.
-
Library Versioning Authored new versions / releases of Boost libraries. With 10 contributions, you will earn the bronze badge for Library Versioning.
-
Mailing List Participation Participation on the Boost developers mailing list. With 1 contribution, you will earn the bronze badge for Mailing List Participation.
-
News Posts Published Articles / news posts published on Boost.org. With 1 contribution, you will earn the bronze badge for News Posts Published.
<h1>LEAF</h1> <blockquote> <p>A lightweight error handling library for C++11.</p> </blockquote> <h2>Documentation</h2> <p>https://boostorg.github.io/leaf/</p> <h2>Features</h2> <ul> <li>Portable single-header format, no dependencies.</li> <li>Tiny code size, configurable for embedded development.</li> <li>No dynamic memory allocations, even with very large payloads.</li> <li>Deterministic unbiased efficiency on the "happy" path and the "sad" path.</li> <li>Error objects are handled in constant time, independent of call stack depth.</li> <li>Can be used with or without exception handling.</li> </ul> <h2>Support</h2> <ul> <li><a href="https://Cpplang.slack.com">cpplang on Slack</a> (use the <code>#boost</code> channel)</li> <li><a href="https://lists.boost.org/mailman/listinfo.cgi/boost-users">Boost Users Mailing List</a></li> <li><a href="https://lists.boost.org/mailman/listinfo.cgi/boost">Boost Developers Mailing List</a></li> </ul> <h2>Distribution</h2> <p>Besides GitHub, there are two other distribution channels:</p> <ul> <li>LEAF is included in official <a href="https://www.boost.org/">Boost</a> releases, starting with Boost 1.75.</li> <li>For maximum portability, the library is also available in single-header format: <a href="https://raw.githubusercontent.com/boostorg/leaf/gh-pages/leaf.hpp">leaf.hpp</a>.</li> </ul> <p>Copyright 2018-2025 Emil Dotchevski and Reverge Studios, Inc. Distributed under the http://www.boost.org/LICENSE_1_0.txt[Boost Software License, Version 1.0].</p>
-
Achievement-based Reflects the depth of your contributions. Accumulate achievements to unlock five tiers; Bronze, Silver, Gold, Platinum and Diamond.
-
Tenure-based Awarded in recognition of your time on the platform. The longer you've been part of the Boost community, the higher the tier you unlock.
-
Boost day celebration A celebration of the day you joined Boost. Awarded annually to mark another year as part of the community.
