etl

嵌入式模板庫（ETL）

項目文檔

動機

C ++是一種很好的語言，用於嵌入式應用程序，模板是一個有力的方面。標準庫可以提供大量經過良好測試的功能，但是標準庫的某些部分與確定性行為和有限的資源要求不太吻合。這些限制通常排除使用動態分配的內存和具有開放尺寸的容器。

需要的是一個模板庫，用戶可以在其中聲明任何對象的大小或最大大小。大多數嵌入式編譯器當前不支持C ++ 03以外的標準，因此不包括程序員使用後來庫的增強功能。

這就是ETL試圖實現的目標。

概括

ETL的設計並非完全替換STL，而是為其進行補充。它的設計目標涵蓋了三個領域。

• 創建一組容器，其中在編譯時確定大小或最大尺寸。這些容器是STL中提供的直接等效物。
• 與C ++ 03兼容，但盡可能多地實現C ++ 11/14/20添加。
• 添加標準庫中不存在的其他有用組件。

嵌入式模板庫是為較低資源嵌入式應用程序設計的。它包含一組容器，算法和實用程序，其中一些模擬了STL的一部分。沒有動態內存分配。圖書館不使用堆。所有容器均具有固定容量，允許在編譯時確定所有內存分配。該庫均適用於支持C ++ 98/03/11/14/17/20的任何編譯器。

主要功能

• 跨平台。該庫不是任何處理器類型的特定特定的。
• 沒有動態內存分配
• 無需RTTI
• 幾乎沒有使用虛擬功能。僅當它們絕對必要的功能時才使用
• 一組固定容量容器。 （數組，bitset，Deque，forward_list，list，隊列，堆棧，向量，地圖，設置等）
• 由於所有容器類型的存儲都被分配為連續塊，因此它們非常緩存友好
• 模板編譯時間常數
• 模板設計模式基類（訪客，觀察者）
• 逆向工程的C ++ 0x11功能（類型特徵，算法，容器等）
• 類型安全枚舉
• 類型安全的類型
• 8、16、32和64位CRC計算
• 校驗和哈希功能
• 變體（可以將許多類型存儲在類型安全接口中的類型）
• 選擇斷言，異常，錯誤處理程序或沒有檢查錯誤的檢查
• 使用VS2022，GCC 12，Clang 14進行了測試（目前超過9400個測試）。
• 許多用於模板支持的實用程序。
• 易於閱讀和記錄的來源。
• 通過電子郵件，GitHub和Slack免費支持

感謝將圖書館放置在不同平台和編譯器下工作的任何幫助。我對使用Keil，IAR，Green Hills，Ti Code Composer等，Bare Metal或RTO和DSP的人特別感興趣。

有關最新信息，請參見（https://www.etlcpp.com）。

安裝此庫

您可以在此處找到設置步驟。

cmake

使用此庫的一種方法是將其放在項目目錄中的某個位置，然後通過使用add_subdirectory提供庫

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

如果將ETL庫用作GIT子模塊，則可以通過允許在庫根目錄外面查找GIT文件夾來進行適當的ETL版本分辨率。

 set (GIT_DIR_LOOKUP_POLICY ALLOW_LOOKING_ABOVE_CMAKE_SOURCE_DIR)
add_subdirectory (etl)

如果要使用CMAKE安裝此庫，則可以執行以下步驟。在Linux上，安裝庫可能需要超級用戶權利，因此可能有必要在最後一個命令之前添加sudo ：

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

安裝庫後，您可以使用find_package使用庫。將<majorVersionRequirement>替換為所需的主要版本：

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

另外，您可以使用FetchContent，用基於git標籤安裝的版本代替<targetVersion> ：

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)

Arduino庫

此存儲庫的內容可作為Arduino IDE中的庫（在IDE庫管理器中搜索“嵌入式模板庫”）。 Arduino庫存儲庫可在https://github.com/ETLCPP/etl-arduino上獲得，有關更多詳細信息，請參見那裡。