khoih-prog/standardcplusplus

Standard C++ for Arduino (port of uClibc++)

Standard C++ for Arduino

This Fork

This implementation targets Arduino Uno since Due does have a proper GNU stdlib implementation, so do ESP8266 and ESP32. The original project is based on uClibc++; I have added missing C++11 / C++14 / C++17 parts from GCC and clang/llvm implementations (libstdc++).

Contributions welcome. I am always active on Github and will accept pull requests promptly.
☀️ Unlike the original, this project has "Issues" tab! Feel free to use it. ☀️

Folllowing is the README from the SGSSGene/StandardCplusplus project (this fork's origin).

What is this?

This is a straight port of uClibc++ for Arduino. I have cut nothing out and held nothing back. Use with care!

That said, I have used uClibc++'s own internal configuration to pare back un-needed stuff, like support for floats, gratuitous template instantiations and other things. See system_configuration.h for all of those gory details.

Plus I added in Andy Brown's excellent ohserialstream class for managing the HardwareSerial as an ostream.

How do I install it?

This is installed just like a regular Arduino library. Unpack the contents of the distribution into the 'libraries' folder under your sketchbook. For example, my sketchbook is at /home/maniacbug/Source/Arduino, so this library is in /home/maniacbug/Source/Arduino/libraries/StandardCplusplus .

Be sure to reset your Arduino IDE after installing it.

How do I use it?

You need an extra #include. It has to come before C++ standard library #includes:

#include <StandardCplusplus.h>

Otherwise, you will see cryptic messages like this:

fatal error: vector: No such file or directory

How do I try it out?

From the Arduino IDE, navigate the menus to: File > Examples > StandardCplusplus > string_vector

Upload that, set your serial monitor to 57600 baud, and check the output.

How do I learn more?

The web is your friend. cplusplus.com is my personal favorite reference.

Which versions does it work with?

Arduino 1.0 and beyond.

What is the license?

uClibc++ is LGPL, so this port is also. Andy's file is actually CC-BY-SA, however he indicated he'd be releasing it using the 3-clause modified BSD license, so it will be fully compatible with uClibc++.