Please find all about the ALib For C++, including
- Programmer's Manuals
- Reference Documentation
- Tutorials
- Project setup guide
- Version History / Change log
at the ALib Homepage.
ALib is a general purpose, use-case agnostic, platform-independent, low-level C++ class library.
Its mission is to provide foundational concepts, types and idioms relevant to any C++ project. As of today, ALib consists of 17 modules, each addressing different topics. A subset of the available modules can be selectively included in a custom library build. This means you only get what you choose from the menu.
Some highlights of the functionality:
- ALib Strings: String-types with interfaces similar to Java/C#, compatible with anything that "smells" like a string (due to some template meta programming magic).
- ALib Boxing: Consider this "std::any on steroids".
- ALib Enums: Finally, we get what we expected from C++ enums.
- ALib Monomem: Monotonic allocation with recycling. Why use the oh-so-slow heap?
- ALib ALox: Logging for adults.
- ALib Bitbuffer: Write bit-streams instead of human-readable text.
- ALib CLI: Command line parser with support of environment variables and configuration files.
- ALib Expressions: Type-safe run-time expression compiler. Easily extensible to support your custom expression functions. 130+ (optional) predefined functions (math, string compare, date/time, etc.)
- ALib Configuration: Run-time variables for C++. Its priority-management allows hard-coding defaults and having them be overridden by configuration files, environment-variables or command-line parameters.
- ALib Files: A directory and file scanner (with run-time expression support)
- ALib Threadmodel: A dynamic thread-pool implementation, dedicated worker threads with prioritized job-management, and periodic event-triggering.
- And last but not least: Many more tools like managing bootstrapping of C++ software, externalized resources, configuration data, singletons with Windows DLLs, ...
- ALib is free software.
- Compiles and tested with C++ 17, 20, and 23.
- Modularization: Possible selective use and compilation of the library.
- Extensive documentation.
- Least intrusive: Designed to keep user code independent of ALib types and idioms when possible.
- Ease of use by design. When things become complex, features are hidden behind default behavior and are only available to users who investigate deeper. For example, by consulting the detail chapters of the Programmer's Manuals. There is one available for each module.
- Developed and steadily tested under GNU/Linux, Windows OS, macOS, and Raspberry Pi-devices. For details in respect to the current release, see the section below.
The following documentation is provided:
-
A \ref alib_manual General Library Manual is available describing the library structure, its setup and compilation, bootstrapping, etc.
-
Separated Programmer's Manuals are published with the ALib Homepage! One dedicated manual is provided for each ALib Module.
The manuals are well-structured, provide step-by-step sourcecode tutorials and sometimes go into in-depth discussion in respect to design decisions and overall rationals behind important features of the ALib Modules.
-
Reference Documentation which is covering 100% of the provided types, members, functions, namespaces, macros, etc. In short, each and every C++ entity is documented.
-
A detailed version history, documenting every interface change is found in the Changelog.
-
All documentation provided leverages the full power of Doxygen (the industry standard).
Therefore, changes in the library's interfaces are always detected and corrected. The many code samples are implemented as unit tests and thus are "live"-integrated to the documentation, often with the output text snippets of the recent unit test run. (See an example here).
Summary: ALib comes with a complete book of documentation, which has more than 1000 pages if it was printed. It is all explained, for beginners and experts!
The current Version got tested on the following platform combinations:
- GNU/Linux Arch 6.12.1, GNU C++ 14.2.1 / Clang++ 18.1.8, C++ 17/20/23, 32-Bit / 64-Bit
(This is the main development platform.) - WindowsOS 10/11, MSC 19.42 (Visual Studio 2022), C++ 17/20, 32-Bit / 64-Bit
- WindowsOS 10/11, MinGW, GCC 13.47 C++ 17/20, 64-Bit
- macOS Sequoia 15.2, Apple M2 / ARM64, Apple Clang Version 16.0.0, C++ 17/20/23, 64-Bit
- Raspberry 3, ARM, 64-bit OS, GNU C++ 12.2.0, C++ 17/20/23
- Raspberry 4, ARM, 64-bit OS, GNU C++ 12.2.0, C++ 17/20/23
The Programmer's Manual contains an extensive chapter about how to compile and use ALib in your C++ environment.
Parts of ALib have sibling incarnations in programming languages C# and JAVA. Historically, ALib aimed to be a cross platform/cross language library. This goal was (mostly) dropped in favor to be able to independently develop ALib for C++.
ALib for C# and ALib for Java are included in and distributed with the cross platform ALox Logging Library.
ALib is free software, can be downloaded at Github and sources are published under Boost Software License
ALib compiles as is, hence it is not dependent on any 3rd-party library. Optional dependencies exist. For example, if boost is available, ALib Strings are using its regex-search. In contrast, ALib provides optional compatibility headers for 3rd-party libraries (e.g., QT Class Library), which, for example, provide adoptions of ALib type-traits for QT-types.
We would be happy if the community started to support this library and are willing to receive contributions and, if accepted, to update the code accordingly.
Note that for legal reasons, we hereby explicitly refuse and reject code (or ideas for code) that are not explicitly provided under the Boost Software License. Please do not even contact us with your ideas/code in that case.
Our thanks go to all supporters that did and do help to realize this project. Furthermore, to just all of these millions of supporters of free software, including:
- The GNU/Linux project and community,
- The LLVM/Clang project,
- The CMake project,
- The QT Creator team,
- Microsoft for providing Visual Studio Community Edition project,
- To company JetBrains for providing a free license to open source developers of their absolutely superb and unrivalled set of IDEs for various programming languages.
- To Dimitri van Heesch for providing marvelous documentation software Doxygen.
- Uniki GmbH for supporting cross-platform compatibility tests.
Special thanks also to C. Darwin, who created life on earth hundreds of millions of years ago, until he - when things became too crazy - disappeared in 1882.
Please visit the ALib Homepage!