Modules C++20

Avertissement

Cette fonctionnalité est encore en développement, et l'API pourrait changer dans les futures versions. Votre contribution est nécessaire pour nous aider à améliorer la compatibilité et l'utilisabilité des modules C++ dans FTXUI. Si vous rencontrez des problèmes ou avez des suggestions, veuillez ouvrir une issue.

FTXUI prend en charge expérimentalement les modules C++20 pour réduire les temps de compilation et améliorer l'organisation du code. Chaque partie de la bibliothèque a un module correspondant, divisé en partitions par chaque en-tête.

Utilisez l'option FTXUI_BUILD_MODULES pour compiler le projet FTXUI lui-même afin de fournir des modules C++20, par exemple avec CMake et Ninja :

cmake \
    -DCMAKE_GENERATOR=Ninja \
    -DFTXUI_BUILD_MODULES=ON \
    ..
 
ninja

Note

Pour utiliser les modules, vous avez besoin d'un compilateur compatible C++≥20, de CMake version 3.20 ou supérieure, et d'utiliser un générateur compatible comme Ninja. Notez que les générateurs Makefile ne supportent pas les modules.

Ensuite, dans votre propre code, vous pouvez consommer les modules et le code comme d'habitude :

import ftxui;
 
using ftxui::Button;
using ftxui::ScreenInteractive;
 
int main() {
  auto screen = ScreenInteractive::TerminalOutput();
  auto button = Button("Click me", screen.QuitClosure());
  screen.Loop(button);
  return 0;
}

Notez le module de commodité ftxui qui rassemble simplement tous les modules :

export import ftxui.component;
export import ftxui.dom;
export import ftxui.screen;
export import ftxui.util;

Vous pouvez importer uniquement le ou les modules dont vous avez besoin si vous le souhaitez.

Pour trouver et lier correctement les modules avec CMake, utilisez target_link_libraries pour obtenir les bons flags de compilateur, linker, etc.

target_link_libraries(my_executable
    #...whatever...
    PRIVATE ftxui::modules
)

Liste des modules

Les modules référencent directement l'en-tête correspondant, ou un groupe d'en-têtes liés pour fournir une interface plus pratique. Les modules suivants sont disponibles :

• ftxui
  • ftxui.component
  • ftxui.dom
  • ftxui.screen
  • ftxui.util