Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/oktonion/stdex
std C++ 11 library impementation with extra features using only C++ 98 and POSIX threads
https://github.com/oktonion/stdex
boost borland c-plus-plus cpp cpp03 cpp11 cpp98 cpp98-compatible cppstl gcc library portable posix posix-threads qnx std-library stdex stl visual-studio
Last synced: about 18 hours ago
JSON representation
std C++ 11 library impementation with extra features using only C++ 98 and POSIX threads
- Host: GitHub
- URL: https://github.com/oktonion/stdex
- Owner: oktonion
- License: mit
- Created: 2017-12-18T19:40:28.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2024-03-13T12:59:41.000Z (7 months ago)
- Last Synced: 2024-09-24T20:55:17.291Z (about 23 hours ago)
- Topics: boost, borland, c-plus-plus, cpp, cpp03, cpp11, cpp98, cpp98-compatible, cppstl, gcc, library, portable, posix, posix-threads, qnx, std-library, stdex, stl, visual-studio
- Language: C++
- Homepage:
- Size: 2.61 MB
- Stars: 65
- Watchers: 5
- Forks: 6
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
### CI Status and tests coverage
Branch | Appveyor| Github | Codecov
---------|---------|---------|---------
tests (development) | [](https://ci.appveyor.com/project/oktonion/stdex) | [](https://github.com/oktonion/stdex/actions/workflows/c-cpp.yml)| [](https://codecov.io/gh/oktonion/stdex/branch/tests)
master | [](https://ci.appveyor.com/project/oktonion/stdex-a309e/branch/master) | [](https://github.com/oktonion/stdex/actions/workflows/c-cpp.yml) | [](https://codecov.io/gh/oktonion/stdex)
[](https://github.com/oktonion/stdex/actions/workflows/codeql.yml) | [](https://www.codacy.com/app/oktonion/stdex?utm_source=github.com&utm_medium=referral&utm_content=oktonion/stdex&utm_campaign=Badge_Grade)
# stdex
[](https://github.com/oktonion/stdex/wiki)
C++ 11 standard library implementation with extra features using C++98 only and POSIX threads. Minimum ugly preprocessor macro and no configuration files. The library itself is built on top of C++ standard library distributed with your compiler and just extends it with C++11 features.
[Usage examples on Wiki](https://github.com/oktonion/stdex/wiki/Architecture-overview#what-to-expect)
## Supported platforms
* Windows (from XP to 10)
* Unix (any with `glibc` and `pthread`)
* MacOS (any)
* QNX 6.x.x
* QNX 4 (partly)
[Wiki](https://github.com/oktonion/stdex/wiki) for more details.
Q: Why not [Boost](https://github.com/boostorg)?
A:
1. Because I can.
2. Because I need something without such overhead and ugliness (ugliness and beauty actually, I am really amazed by how Boost handles some features of C++).
3. Because I want all of basic little helpful classes and tricks (as `countof` f.e.) be in one place with power of C++ 11 threads handling and template-programming.
C++ 11 implemented features list
### Language core
* **nullptr** and `stdex::nullptr_t`
* **static_assert** or `STATIC_ASSERT` macro
* **stdex_char16_t** and **stdex_char32_t** (as equivalent to **char16_t**, **char32_t**)
* **stdex_noexcept** (as partial equivalent to **noexcept**)
* `stdex_assert` macro (as equivalent to `cassert` macro)
* move semantic is in progress
### Utilities library
| name | purpose | implemented | is final |
|----------------------|--------------------------------------------------------------------------------|:------------:|----------|
| `` | stdex::type_index | 100% | maybe |
| `` | Compile-time type information | 70% | no |
| `` | Function objects, Function invocations, Bind operations and Reference wrappers | no | no |
| `` | C++ time utilities | 100% | yes |
| `` | stdex::initializer_list class template | no and never | yes |
| `` | stdex::tuple class template | no | no |
### Dynamic memory management
| name | purpose | implemented | is final |
|----------------------|------------------------|:------------:|----------|
| `` | Nested allocator class | no | maybe |
### Numeric limits
| name | purpose | implemented | is final |
|----------------------|----------------------------------------------------------------|:------------:|----------|
| `` | fixed-size types and limits of other types | 99% | maybe |
| `` | formatting macros, intmax_t and uintmax_t math and conversions | no | maybe |
### Error handling
| name | purpose | implemented | is final |
|----------------------|------------------------------------------------------------|:------------:|----------|
| `` | defines stdex::error_code, a platform-dependent error code | 100% | yes |
### Strings library
| name | purpose | implemented | is final |
|----------------------|---------------------------------------------------------|:------------:|----------|
| `` | C-style Unicode character conversion functions | no | maybe |
| `` | stdex::basic_string, stdex::stoi, stdex::to_string etc. | 50% | no |
### Containers library
| name | purpose | implemented | is final |
|-------------------|----------------------------------------|:-----------:|----------|
| `` | stdex::array container | no | maybe |
| `` | stdex::forward_list container | no | maybe |
| `` | unordered associative `set` containers | no | maybe |
| `` | unordered associative `map` containers | no | maybe |
### Iterators library
| name | purpose | implemented | is final |
|-------------------|-----------------|:-----------:|----------|
| `` | Range iterators | 100% | yes |
### Algorithms library
| name | purpose | implemented | is final |
|-------------------|-----------------------------------|:-----------:|----------|
| `` | Algorithms that operate on ranges | 100% | yes |
### Numerics library
| name | purpose | implemented | is final |
|-------------------|---------------------------------------------|:-----------:|----------|
| `` | Random number generators and distributions | no | maybe |
| `` | Compile-time rational arithmetic | 99% | maybe |
| `` | Floating-point environment access functions | no | maybe |
### Input/output library
| name | purpose | implemented | is final |
|-------------------|------------------------------------------------------------------------------------------------------------------------|:-----------:|----------|
| `` | stdex::basic_stringstream, stdex::basic_istringstream, stdex::basic_ostringstream class templates and several typedefs | 30% | maybe |
### Regular Expressions library
| name | purpose | implemented | is final |
|-------------------|----------------------------------------------------------------------------|:-----------:|----------|
| `` | Classes, algorithms and iterators to support regular expression processing | no | maybe |
### Atomic Operations library
| name | purpose | implemented | is final |
|-------------------|---------------------------|:-----------:|----------|
| `` | Atomic operations library | no | no |
### Thread support library
| name | purpose | implemented | is final |
|------------------------|-----------------------------------------------|:-----------:|----------|
| `` | stdex::thread class and supporting functions | 90% | no |
| `` | mutual exclusion primitives | 90% | no |
| `` | primitives for asynchronous computations | no | maybe |
| `` | thread waiting conditions | 100% | yes |
Not all features of C++ 11 can be implemented without compiler support so I have no plans to include such features in the library.
The library is portable for any compiler that supports C++98 but as we all know there are lots of different implementations of std library in even major compilers so this library is tested with:
* `Borland C++ Builder 6.0` Updt4;
* `qcc` (just a wrapper over `gcc` in QNX)
* `g++` 3.4, 4.4.2, 4.4, 4.6;
* `g++` 4.8, 4.9, 5.0 with c++98 option;
* `clang` 3.5, 5.0 with c++98 option;
* `clang-900.0.37` with c++98 option (Mac OS);
* `Visual Studio` 2008, 2010, 2013, 2015, 2017;
...and that's it. If you use other compilers and decide to include this library in your project there is no guarantee that it will compile without errors. In case you will be able to fix the errors without breaking existing code for already supported compilers I would really appreciate your pull requests.
For the C++ threads (mutexes, threads) I'm using POSIX threads implementation. There is [one](https://github.com/oktonion/pthread-win32 "I'm using this implementation") for Windows platform and definitely should be one for every POSIX-friendly platform.
The library is in development so no backward compatibility guaranteed with previous versions of **stdex**. But one thing for sure: it will be more and more standard in the way of std library for C++ 11.
# how to build
Build process is simple:
* For Unix - either run a `build_lib.sh` script (works with `g++` and `clang` if environment variable `$COMPILER` is set to compiler name, f.e. to `clang++-3.5`) or build by yourself static library from `stdex/src` directory sources.
* For Windows
* * run a `build_lib.bat` script that works with Visual Studio's `cl` if environment variables are set by `v{s/c}vars{32/64/all}.bat` (`vcvars32.bat`, `vsvars32.bat` etc.) script that is in your Visual Studio distributive;
* * run a `build_lib_bcc32.bat` script for Borland C++ Builder 6.0 Updt4 `bcc32` build;
* * ...or build by yourself the static library from `stdex/src` and `pthreads-win32` directories sources.
* For QNX 6.x.x - either run a `build_lib_qnx.sh` (using `qcc` compiler) or build by yourself the static library from `stdex/src` directory sources (do not forget to link with `stdlib` library).
* For Mac OS - either run a `build_lib.sh` script (works with clang if environment variable `$COMPILER` is set to compiler name, f.e. to `clang++-3.5`) or build by yourself static library from `stdex/src` directory sources.
# how to include in your project
In your project:
1. include sources of the library or link with prebuild static library (`.a`/`.lib` file, f.e. `libstdex.a`/`stdex.lib`)
2. link with system libraries for POSIX-threads and real-time clocks:
* `librt.lib` and `libpthread.lib` for UNIX;
* [POSIX-threads lib](https://github.com/oktonion/pthread-win32 "I'm using this implementation") for Windows (if you have built stdex static library with `pthreads-win32` sources then you have no need to link with pthreads anymore - it's already in `stdex.lib`);
* `m.lib` for QNX 6.x.x;
* `libpthread.lib` for Mac OS;
3. enjoy
example script build for Ubuntu (with `g++` installed):
```sh
COMPILER=g++
$COMPILER main.cpp -L./stdex/lib/ -lstdex -lrt -lpthread -o "./bin/main"
```
example script build for Windows (with Visual Studio 2008 and Windows Kit 8.1 installed):
```bat
call "C:\Program Files (x86)\Microsoft Visual Studio 9.0\Common7\Tools\vsvars32.bat"
set LIB=%LIB%C:\Program Files (x86)\Windows Kits\8.1\Lib\winv6.3\um\x86\;
set INCLUDE=%INCLUDE%;%cd%\pthread;
cl -EHsc -Fo.\obj\main.obj -c ".\main.cpp"
cl .\obj\main.obj stdex.lib -Fe.\bin\main.exe -link -LIBPATH:.\stdex\lib
```
example script build for Windows (with Borland C++ Builder 6.0 Updt4):
```bat
bcc32 -w-inl -w-ccc -tWM -Q -n.\obj\ -I%cd%\pthread\ -c ".\main.cpp"
bcc32 -w-inl -w-ccc -tWM -Q -L.\stdex\lib\ -lap -I%cd%\pthread\ -e.\bin\main.exe stdex.lib cw32mt.lib .\obj\main.obj
```
example script build for QNX 6.x.x (with `qcc` installed):
```sh
COMPILER=qcc
$COMPILER main.cpp -L./stdex/lib/ -lstdex -lm -o "./bin/main"
```
example script build for Mac OS (with `clang` installed):
```sh
COMPILER=clang++
$COMPILER main.cpp -L./stdex/lib/ -lstdex -lpthread -o "./bin/main"
```
visit [https://github.com/oktonion/stdex](https://github.com/oktonion/stdex) for the latest version of stdex library