etl

Bibliothèque de modèles intégrés (ETL)

Documentation du projet

Motivation

C ++ est une excellente langue à utiliser pour les applications intégrées et les modèles sont un aspect puissant. La bibliothèque standard peut offrir beaucoup de fonctionnalités bien testées, mais il existe certaines parties de la bibliothèque standard qui ne correspondent pas bien aux comportements déterministes et aux exigences de ressources limitées. Ces limitations empêchent généralement l'utilisation de la mémoire et des conteneurs alloués dynamiquement avec des tailles ouvertes.

Ce qui est nécessaire, c'est une bibliothèque de modèles où l'utilisateur peut déclarer la taille ou la taille maximale de tout objet à l'avance. La plupart des compilateurs intégrés ne prennent pas actuellement en charge la norme au-delà de C ++ 03, excluant ainsi le programmeur d'utilisation des fonctionnalités améliorées de la bibliothèque ultérieure.

C'est ce que l'ETL tente de réaliser.

Résumé

L'ETL n'est pas conçu pour remplacer complètement le STL, mais le compléte. Son objectif de conception couvre trois domaines.

• Créez un ensemble de conteneurs où la taille ou la taille maximale est déterminée au moment de la compilation. Ces conteneurs sont des équivalents directs de ceux fournis dans la STL.
• Soyez compatible avec C ++ 03 mais implémentez autant des ajouts C ++ 11/14/17/20 possible.
• Ajoutez d'autres composants utiles qui ne sont pas présents dans la bibliothèque standard.

La bibliothèque de modèles embarquée a été conçue pour des applications intégrées de ressources inférieures. Il contient un ensemble de conteneurs, d'algorithmes et de services publics, dont certains imitent des parties de la STL. Il n'y a pas d'allocation de mémoire dynamique. La bibliothèque ne fait aucun usage du tas. Tous les conteneurs ont une capacité fixe permettant de déterminer toute allocation de mémoire au moment de la compilation. La bibliothèque est destinée à tout compilateur qui prend en charge C ++ 98/03/11/14/17/20.

Caractéristiques principales

• Cross Platform. Cette bibliothèque n'est spécifique à aucun type de processeur.
• Aucune allocation de mémoire dynamique
• Aucun RTTI requis
• Très peu d'utilisation des fonctions virtuelles. Ils ne sont utilisés que lorsqu'ils sont absolument nécessaires pour les fonctionnalités requises
• Un ensemble de conteneurs à capacité fixe. (Array, Bitset, Deque, Forward_List, List, Fitre, Stack, Vector, Map, Set, etc.)
• Comme le stockage de tous les types de conteneurs est alloué comme un bloc contigu, ils sont extrêmement conviviaux en cache
• Constantes de temps de compilation à modèle
• Classes de base de motifs de conception à modèle (visiteur, observateur)
• Fonctionnalités C ++ 0x11 à l'origine inversée (traits de type, algorithmes, conteneurs, etc.)
• Énumérations de type
• Types de type
• Calculs CRC 8, 16, 32 et 64 bits
• Somme de contrôle et fonctions de hachage
• Variantes (un type qui peut stocker de nombreux types dans une interface de type type)
• Choix des affirmations, des exceptions, du gestionnaire d'erreurs ou pas de vérifications sur les erreurs
• Testé unitaire (actuellement plus de 9400 tests), en utilisant VS2022, GCC 12, Clang 14.
• De nombreux utilitaires pour la prise en charge des modèles.
• Source facile à lire et documentée.
• Support gratuit par e-mail, github et slack

Toute aide portant la bibliothèque à travailler sous différentes plates-formes et compilateurs serait reçue avec gratitude. Je suis particulièrement intéressé par les personnes qui utilisent Keil, Iar, Green Hills, Ti Code Composer, etc., Bare Metal ou RTOS et DSPS.

Voir (https://www.etlcpp.com) pour des informations à jour.

Installation de cette bibliothèque

Vous pouvez trouver les étapes de configuration ici.

Cmake

Une façon d'utiliser cette bibliothèque est de la déposer quelque part dans votre répertoire de projet, puis de rendre la bibliothèque disponible en utilisant add_subdirectory

 add_subdirectory (etl)
add_executable (foo main.cpp)
target_link_libraries (foo PRIVATE etl::etl)

Si la bibliothèque ETL est utilisée comme sous-module GIT, elle peut nécessiter une configuration supplémentaire pour une résolution de version ETL appropriée en permettant à la recherche de dossier GIT en dehors du répertoire racine de la bibliothèque.

 set (GIT_DIR_LOOKUP_POLICY ALLOW_LOOKING_ABOVE_CMAKE_SOURCE_DIR)
add_subdirectory (etl)

Si vous souhaitez installer cette bibliothèque avec CMake, vous pouvez effectuer les étapes suivantes. Sur Linux, les droits des super utilisateurs peuvent être nécessaires pour installer la bibliothèque, il peut donc être nécessaire d'ajouter sudo avant la dernière commande:

git clone https://github.com/ETLCPP/etl.git
cd etl
git checkout < targetVersion >
cmake -B build .
cmake --install build/

Une fois la bibliothèque installée, vous pouvez utiliser find_package pour utiliser la bibliothèque. Remplacez <majorVersionRequirement> par la version majeure souhaitée:

 find_package (etl <majorVersionRequirement>)
add_executable (foo main.cpp)
target_link_libraries (foo PRIVATE etl::etl)

Alternativement, vous pouvez utiliser FetchContent, en remplaçant <targetVersion> par la version à installer en fonction d'une balise GIT:

Include(FetchContent)

FetchContent_Declare(
  etl
  GIT_REPOSITORY https://github.com/ETLCPP/etl
  GIT_TAG        < targetVersion >
)

FetchContent_MakeAvailable(etl)

add_executable(foo main.cpp)
target_link_libraries(foo PRIVATE etl::etl)

Bibliothèque Arduino

Le contenu de ce dépôt est disponible en bibliothèque dans le Arduino IDE (recherchez la "bibliothèque de modèles intégrée" dans le gestionnaire de bibliothèque IDE). Le référentiel de la bibliothèque Arduino est disponible sur https://github.com/ETLCPP/etl-arduino , voir là-bas pour plus de détails.