Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ibob/itlib
A collection of std-like single-header C++ libraries
https://github.com/ibob/itlib
collection cpp flat-map static-vector
Last synced: 3 days ago
JSON representation
A collection of std-like single-header C++ libraries
- Host: GitHub
- URL: https://github.com/ibob/itlib
- Owner: iboB
- License: mit
- Created: 2020-10-14T12:59:51.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2024-09-26T12:28:35.000Z (about 1 month ago)
- Last Synced: 2024-10-10T01:49:34.362Z (29 days ago)
- Topics: collection, cpp, flat-map, static-vector
- Language: C++
- Homepage:
- Size: 679 KB
- Stars: 156
- Watchers: 9
- Forks: 13
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
itlib: iboB's Template Libraries
================================
A collection of small single-header C++ libraries similar to or extending the C++ standard library. See below for a list.
[](https://isocpp.org/) [](https://opensource.org/licenses/MIT)
itlib was forked from [chobo-shl](https://github.com/Chobolabs/chobo-shl) which is no longer supported. New libraries and updates to the existing ones are added here.
## Build Status
Building with GitHub actions on Windows with MSVC, Ubuntu with GCC, and macOS with clang. Debug and Release. With address sanitizer and thread sanitizer where applicable.
[](https://github.com/iboB/itlib/actions?query=workflow%3ABuild)
## Libraries
Every `.hpp` file in `include/itlib` is a standalone library and has no dependencies other than the standard lib.
Documentation is provided in comments at the top of each file.
In the list below each library shows its minimum supported C++ standard and has icons for other standards if additional features are available for them.
Library | Description
---------|-------------
[**any.hpp**](https://github.com/iboB/itlib/blob/master/include/itlib/any.hpp) [](https://en.wikipedia.org/wiki/C%2B%2B#Standardization) | An alternative implementation of C++17's `std::any` without the limitation of required copyability for the values inside and with the possibility to set a custom allocator.
[**atomic.hpp**](https://github.com/iboB/itlib/blob/master/include/itlib/atomic.hpp) [](https://en.wikipedia.org/wiki/C%2B%2B#Standardization) | Utility extensions for ``.
[**atomic_shared_ptr_storage.hpp**](https://github.com/iboB/itlib/blob/master/include/itlib/atomic_shared_ptr_storage.hpp) [](https://en.wikipedia.org/wiki/C%2B%2B#Standardization) | A wrapper for `std::shared_ptr` which allows atomic load, store and exchange. An alternative to C++20's `std::atomic>`.
[**data_mutex.hpp**](https://github.com/iboB/itlib/blob/master/include/itlib/data_mutex.hpp) [](https://en.wikipedia.org/wiki/C%2B%2B#Standardization) [](https://en.wikipedia.org/wiki/C%2B%2B#Standardization) | A template pair of an object and a mutex used to synchronize access to it. It makes it hard to cause bugs by forgetting to lock a mutex associated with an object.
[**dynamic_bitset.hpp**](https://github.com/iboB/itlib/blob/master/include/itlib/dynamic_bitset.hpp) [](https://en.wikipedia.org/wiki/C%2B%2B#Standardization) | A class similar to `std::bitset`, but the number of bits is not a part of the type. It's also somewhat similar to `std::vector`, but (so far) it has more limited modification capabilities.
[**expected.hpp**](https://github.com/iboB/itlib/blob/master/include/itlib/expected.hpp) [](https://en.wikipedia.org/wiki/C%2B%2B#Standardization) | A union type of a value and an error. Similar to the [`std::expected`](https://en.cppreference.com/w/cpp/utility/expected) from C++23.
[**flat_map.hpp**](https://github.com/iboB/itlib/blob/master/include/itlib/flat_map.hpp) [](https://en.wikipedia.org/wiki/C%2B%2B#Standardization) | A class with the interface of `std::map` but implemented with an underlying `std::vector`-type container, thus providing better cache locality of the elements. Similar to [`boost::flat_map`](http://www.boost.org/doc/libs/1_61_0/doc/html/boost/container/flat_map.html) with the notable difference that the underlying container can be changed via a template argument.
[**flat_set.hpp**](https://github.com/iboB/itlib/blob/master/include/itlib/flat_set.hpp) [](https://en.wikipedia.org/wiki/C%2B%2B#Standardization) | A class with the interface of `std::set` but implemented with an underlying `std::vector`-type container, thus providing better cache locality of the elements. Similar to [`boost::flat_set`](http://www.boost.org/doc/libs/1_61_0/doc/html/boost/container/flat_set.html) with the notable difference that the underlying container can be changed via a template argument.
[**generator.hpp**](https://github.com/iboB/itlib/blob/master/include/itlib/generator.hpp) [](https://en.wikipedia.org/wiki/C%2B%2B#Standardization) |A helper for making simple generator coroutines with `co_yield`.
[**pmr_allocator.hpp**](https://github.com/iboB/itlib/blob/master/include/itlib/pmr_allocator.hpp) [](https://en.wikipedia.org/wiki/C%2B%2B#Standardization) | A C++17 wrapper of `std::pmr::polymorphic_allocator` which provides functionalities introduced in C++20 for it.
[**mem_streambuf.hpp**](https://github.com/iboB/itlib/tree/master/include/itlib/mem_streambuf.hpp) [](https://en.wikipedia.org/wiki/C%2B%2B#Standardization) | Two helper classes: `mem_ostreambuf` and `mem_istreambuf` which allow you to work with `std::stream`-s with buffers of contiguous memory.
[**mem_streambuf.hpp**](https://github.com/iboB/itlib/tree/master/include/itlib/mem_streambuf.hpp) [](https://en.wikipedia.org/wiki/C%2B%2B#Standardization) | Two helper classes: `mem_ostreambuf` and `mem_istreambuf` which allow you to work with `std::stream`-s with buffers of contiguous memory.
[**pod_vector.hpp**](https://github.com/iboB/itlib/tree/master/include/itlib/pod_vector.hpp) [](https://en.wikipedia.org/wiki/C%2B%2B#Standardization) | A container similar to `std::vector`, which contains PODs. This fact is used to improve performance by skipping constructor and destructor calls and using `memcpy` and `memmove` to copy data, and `malloc` and `free`, and, most importantly `realloc`, and `_expand` if available, to manage memory.
[**poly_span.hpp**](https://github.com/iboB/itlib/tree/master/include/itlib/poly_span.hpp) [](https://en.wikipedia.org/wiki/C%2B%2B#Standardization) | A class similar to C++20's `std::span` which offers a polymorphic view over a buffer of objects.
[**qalgorithm.hpp**](https://github.com/iboB/itlib/tree/master/include/itlib/qalgorithm.hpp) [](https://en.wikipedia.org/wiki/C%2B%2B#Standardization) | Wrappers of `` functions which work on entire containers for less typing in the most common use-cases.
[**rstream.hpp**](https://github.com/iboB/itlib/tree/master/include/itlib/rstream.hpp) [](https://en.wikipedia.org/wiki/C%2B%2B#Standardization) | Read stream. Simple `std::istream` wrappers which don't allow seeks, allowing you to be certain that reads are sequential, and thus allow a redirect, so you can represent several streams as one.
[**sentry.hpp**](https://github.com/iboB/itlib/tree/master/include/itlib/sentry.hpp) [](https://en.wikipedia.org/wiki/C%2B%2B#Standardization) [](https://en.wikipedia.org/wiki/C%2B%2B#Standardization) | A sentry class which executes a function object on destruction. Works with C++11, but it's slightly easier to use with C++17.
[**shared_from.hpp**](https://github.com/iboB/itlib/tree/master/include/itlib/shared_from.hpp) [](https://en.wikipedia.org/wiki/C%2B%2B#Standardization) | A helper class to replace `std::enable_shared_from_this` providing a more powerful interface. Similar to `enable_shared_from` from [Boost.SmartPtr](https://www.boost.org/doc/libs/1_75_0/libs/smart_ptr/doc/html/smart_ptr.html#enable_shared_from)
[**small_vector.hpp**](https://github.com/iboB/itlib/tree/master/include/itlib/small_vector.hpp) [](https://en.wikipedia.org/wiki/C%2B%2B#Standardization) | A mix between `std::vector` and `itlib::static_vector`. It's a dynamic array, optimized for use when the number of elements is small. Like `static_vector` is has a static buffer with a given capacity, but can fall back to dynamically allocated memory, should the size exceed it. Similar to [`boost::small_vector`](http://www.boost.org/doc/libs/1_61_0/doc/html/boost/container/small_vector.html)
[**span.hpp**](https://github.com/iboB/itlib/tree/master/include/itlib/span.hpp) [](https://en.wikipedia.org/wiki/C%2B%2B#Standardization) [](https://en.wikipedia.org/wiki/C%2B%2B#Standardization) | A C++11 implementation of C++20's `std::span`
[**static_vector.hpp**](https://github.com/iboB/itlib/tree/master/include/itlib/static_vector.hpp) [](https://en.wikipedia.org/wiki/C%2B%2B#Standardization) | A mix between `std::vector` and `std::array`: A dynamically sized container with fixed capacity (supplied as a template parameter). This allows you to have dynamically sized vectors on the stack or as cache-local value members, as long as you know a big enough capacity beforehand. Similar to [`boost::static_vector`](http://www.boost.org/doc/libs/1_61_0/doc/html/boost/container/static_vector.html).
[**stride_span.hpp**](https://github.com/iboB/itlib/tree/master/include/itlib/stride_span.hpp) [](https://en.wikipedia.org/wiki/C%2B%2B#Standardization) | A C++11 implementation C++20's of std::span with a dynamic extent *and an associated stride*.
[**strutil.hpp**](https://github.com/iboB/itlib/tree/master/include/itlib/strutil.hpp) [](https://en.wikipedia.org/wiki/C%2B%2B#Standardization) | A collection of small utilities for `std::string_view`
[**throw_ex.hpp**](https://github.com/iboB/itlib/tree/master/include/itlib/throw_ex.hpp) [](https://en.wikipedia.org/wiki/C%2B%2B#Standardization) | Utility to compose and throw exceptions on a single line
[**time_t.hpp**](https://github.com/iboB/itlib/tree/master/include/itlib/time_t.hpp) [](https://en.wikipedia.org/wiki/C%2B%2B#Standardization) | A thin wrapper of `std::time_t` which provides thread safe `std::tm` getters and type-safe (`std::chrono::duration`-based) arithmetic
[**type_traits.hpp**](https://github.com/iboB/itlib/tree/master/include/itlib/type_traits.hpp) [](https://en.wikipedia.org/wiki/C%2B%2B#Standardization) [](https://en.wikipedia.org/wiki/C%2B%2B#Standardization) | Additional type traits to extend the standard library's ``
[**ufunction.hpp**](https://github.com/iboB/itlib/tree/master/include/itlib/ufunction.hpp) [](https://en.wikipedia.org/wiki/C%2B%2B#Standardization) [](https://en.wikipedia.org/wiki/C%2B%2B#Standardization) | Unique function. A replacement of `std::function` which is non-copyable (can capture non-copyable values, and wrap non-copyable objects), and noexcept move-constructible (won't implicitly make owners no-noexcept move-constructible)
[**utility.hpp**](https://github.com/iboB/itlib/tree/master/include/itlib/utility.hpp) [](https://en.wikipedia.org/wiki/C%2B%2B#Standardization) | Several generally unrelated utility functions and helpers
## Usage
Clone the repo or choose one or more libraries that you like and copy them somewhere in your include paths.
Every library is self-contained so you can copy, move, and modify whichever you like and not wory about interdependencies.
## Contributing
Pull requests and issues are welcome.
Please make separate commits per library, tagging them with the library name in the title with brackets. Example:
* *[small_vector] Added insert methods*
* *[flat_map] Crash when using with xxxx container*
You can use CMake to generate a project and run the tests locally.
## Copyright
Copyright © 2016-2019 [Chobolabs Inc.](http://www.chobolabs.com/)
Copyright © 2020-2024 Borislav Stanimirov
These libraries are distributed under the MIT Software License. See LICENSE.txt for further details or copy [here](http://opensource.org/licenses/MIT).