John Wellbelove 70f0b92a0d CRC updates
2021-03-29 13:54:12 +01:00
.circleci Add free-standing sanity tests for C++03/11/14/17 (#351) 2021-03-12 14:13:31 +00:00
.github Intermediate commit 2021-03-24 12:16:19 +00:00
arduino Add free-standing sanity tests for C++03/11/14/17 (#351) 2021-03-12 14:13:31 +00:00
examples Add free-standing sanity tests for C++03/11/14/17 (#351) 2021-03-12 14:13:31 +00:00
images Add free-standing sanity tests for C++03/11/14/17 (#351) 2021-03-12 14:13:31 +00:00
include/etl CRC updates 2021-03-29 13:54:12 +01:00
support Updated version numbers 2021-03-26 17:32:27 +00:00
temp Add free-standing sanity tests for C++03/11/14/17 (#351) 2021-03-12 14:13:31 +00:00
test CRC updates 2021-03-29 13:54:12 +01:00
uml UML framework diagrams 2017-08-03 09:53:33 +01:00
.gitattributes Add free-standing sanity tests for C++03/11/14/17 (#351) 2021-03-12 14:13:31 +00:00
.gitignore Add to ignore file 2021-03-15 10:52:24 +00:00
.gitlab-ci.yml Trigger CI pipelines on gitlab 2018-11-04 10:10:50 +00:00
.gitmodules Merge remote-tracking branch 'origin/feature/CMake' into development 2018-05-31 22:21:09 +01:00
appveyor.yml Add free-standing sanity tests for C++03/11/14/17 (#351) 2021-03-12 14:13:31 +00:00
CMakeLists.txt Add free-standing sanity tests for C++03/11/14/17 (#351) 2021-03-12 14:13:31 +00:00
conanfile.py Add free-standing sanity tests for C++03/11/14/17 (#351) 2021-03-12 14:13:31 +00:00
Doxyfile Updated doxygen file (#131) 2019-06-14 22:41:45 +01:00
file.txt Add free-standing sanity tests for C++03/11/14/17 (#351) 2021-03-12 14:13:31 +00:00
library.json Updated version numbers 2021-03-26 17:32:27 +00:00
library.properties Updated version numbers 2021-03-26 17:32:27 +00:00
LICENSE Merge remote-tracking branch 'origin/master' into development 2018-07-12 21:32:54 +01:00
meson.build Add free-standing sanity tests for C++03/11/14/17 (#351) 2021-03-12 14:13:31 +00:00
README.md Add free-standing sanity tests for C++03/11/14/17 (#351) 2021-03-12 14:13:31 +00:00
todo.txt Merge remote-tracking branch 'origin/feature/etl__make_string' into development 2019-12-04 20:55:18 +00:00

Embedded Template Library (ETL)

GitHub release (latest by date) License CI CI CI Codacy Badge

Motivation

C++ is a great language to use for embedded applications and templates are a powerful aspect. The standard library can offer a great deal of well tested functionality, but there are some parts of the standard library that do not fit well with deterministic behaviour and limited resource requirements. These limitations usually preclude the use of dynamically allocated memory and containers with open ended sizes.

What is needed is a template library where the user can declare the size, or maximum size of any object upfront. Most embedded compilers do not currently support the standard beyond C++ 03, therefore excluding the programmer from using the enhanced features of the later library.

This is what the ETL attempts to achieve.

Summary

The ETL is not designed to completely replace the STL, but complement it. Its design objective covers three areas.

  • Create a set of containers where the size or maximum size is determined at compile time. These containers are direct equivalents of those supplied in the STL.
  • Be compatible with C++ 03 but implement as many of the C++ 11 additions as possible.
  • Add other useful components that are not present in the standard library.

The embedded template library has been designed for lower resource embedded applications. It contains a set of containers, algorithms and utilities, some of which emulate parts of the STL. There is no dynamic memory allocation. The library makes no use of the heap. All of the containers have a fixed capacity allowing all memory allocation to be determined at compile time. The library is intended for any compiler that supports C++ 03.

Main features:

  • Cross platform. This library is not specific to any processor type.
  • No dynamic memory allocation
  • No RTTI required
  • Very little use of virtual functions. They are used only when they are absolutely necessary for the required functionality
  • A set of fixed capacity containers. (array, bitset, deque, forward_list, list, queue, stack, vector, map, set, etc.)
  • As the storage for all of the container types is allocated as a contiguous block, they are extremely cache friendly
  • Templated compile time constants
  • Templated design pattern base classes (Visitor, Observer)
  • Reverse engineered C++ 0x11 features (type traits, algorithms, containers etc.)
  • Type-safe enumerations
  • Type-safe typedefs
  • 8, 16, 32 & 64 bit CRC calculations
  • Checksums & hash functions
  • Variants (a type that can store many types in a type-safe interface)
  • Choice of asserts, exceptions, error handler or no checks on errors
  • Many utilities for template support.
  • Easy to read and documented source.
  • Free email support

Any help porting the library to work under different platforms and compilers would be gratefully received. I am especially interested in people who are using Keil, IAR, Green Hills, TI Code Composer etc, bare metal or RTOS, and DSPs.

See (https://www.etlcpp.com) for up-to-date information.