https://github.com/not-nik/cpp-stalin
A C++ standard library implementation
https://github.com/not-nik/cpp-stalin
cpp cpp11 cpp14 cpp17 cpp20 cpp23 standard-library stl
Last synced: 9 months ago
JSON representation
A C++ standard library implementation
- Host: GitHub
- URL: https://github.com/not-nik/cpp-stalin
- Owner: Not-Nik
- License: mpl-2.0
- Created: 2021-07-08T18:59:31.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-06-06T09:56:07.000Z (over 1 year ago)
- Last Synced: 2025-04-10T15:53:18.028Z (9 months ago)
- Topics: cpp, cpp11, cpp14, cpp17, cpp20, cpp23, standard-library, stl
- Language: C++
- Homepage:
- Size: 315 KB
- Stars: 4
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# cpp-stalin is a C++ standard library implementation
stalin currently only supports a small percentage of the standard. Feel free to contribute to any existing code, or start implementing something new.
## Structure
* `include/` - The main include directory
* `src/` - The source directory. Any implementations for non-template functions are here
* `test/` - Test directory. Contains tests to ensure the functionality of cpp-stalin
## Configuration
Stalin allows you to configure the library to your needs in the `include/__config` file.
* Defining `STALIN_CXX_STD_VERSION_XX` will set the library version to match the standard.
* Defining `STALIN_CXX_STD_STRICT` will make the library comply more strictly to the standard. In non-strict mode stalin will add the `[[maybe_unused]]`
and `[[nodiscard]]` attributes in various places, to silence and generate unused warnings where appropriate.
* Defining `STALIN_CXX_STD_NO_IO` will prevent `basic_filebuf` and the default streams `cin`, `cout`, `cerr` and `clog` as well as their wide counterparts from being
defined. This reduces the actual dependencies[1](#fn_one) [2](#fn_two) of cpp-stalin to the basic memory management functions `malloc`, `realloc`
and `free` and default types defined in `stddef.h` and
`stdio.h`.
* Defining `STALIN_CXX_STD_FREESTANDING` will limit headers to the [freestanding library standard](https://en.cppreference.com/w/cpp/freestanding). Including any other
headers will do nothing.
1: In practice stalin also requires the rest of the C standard library for the `using` directives in the `c*` headers. Most modern
compilers support some way of checking whether a function or type exists so this shouldn't be a big issue.
2: Even if you don't declare/define these functions, your compiler likely won't complain, as long as the stalin functions using them
aren't instantiated. This means that the required functions depend on your usage of the library.