Range-v3 C++ : guide complet avec exemples pratiques

Introduction à range-v3 : qu'est-ce que c'est et pourquoi l'utiliser

La bibliothèque range-v3 est une bibliothèque moderne et puissante pour travailler avec des séquences de données en C++, développée par Eric Niebler. Elle a servi de précurseur et de prototype pour la bibliothèque standard C++20 Ranges. range-v3 offre des outils pratiques, expressifs et sécurisés pour traiter des collections, vecteurs, listes et tout autre objet itérable, en utilisant les concepts d'évaluation paresseuse et de composition d'algorithmes.

Pourquoi utiliser cette bibliothèque ? Les algorithmes STL traditionnels (std::transform, std::copy_if, etc.) travaillent avec des itérateurs, ce qui conduit souvent à un code lourd et difficile à lire. range-v3 résout ce problème en vous permettant de travailler avec des plages entières (ranges) comme des objets uniques. Vous pouvez enchaîner les opérations (pipeline) sans créer de conteneurs temporaires, et écrire un code qui ressemble à une séquence d'étapes plutôt qu'à des appels de fonctions imbriqués.

Principaux avantages :

• Expressivité : le code devient une description déclarative de ce qu'il faut faire, et non comment le faire.
• Paresse : de nombreuses opérations (filtrage, transformation) ne sont exécutées que lorsque cela est vraiment nécessaire, ce qui améliore les performances.
• Composition : il est facile de combiner différents algorithmes avec l'opérateur | (pipe).
• Sécurité : moins d'erreurs liées aux dépassements de limites et à une mauvaise utilisation des itérateurs.
• Compatibilité : fonctionne avec tous les conteneurs STL et les types personnalisés prenant en charge l'itération.

Installation de range-v3

Contrairement à Python ou JavaScript, C++ n'a pas de gestionnaire de paquets unique comme pip ou npm. Cependant, range-v3 est une bibliothèque header-only (composée uniquement de fichiers d'en-tête), ce qui rend son installation très simple.

Méthode 1 : Vcpkg (recommandé pour Windows, Linux, macOS)

Vcpkg est un gestionnaire de paquets multiplateforme pour C++.

# Installez vcpkg si ce n'est pas déjà fait
git clone https://github.com/Microsoft/vcpkg.git
cd vcpkg
./bootstrap-vcpkg.sh  # ou bootstrap-vcpkg.bat pour Windows

# Installez range-v3
./vcpkg install range-v3

# Intégrez dans votre projet (CMake) :
# find_package(range-v3 CONFIG REQUIRED)
# target_link_libraries(my_project PRIVATE range-v3::range-v3 range-v3::meta)

Méthode 2 : Conan

Conan est un autre gestionnaire de paquets populaire.

# Installez Conan
pip install conan

# Ajoutez dans le fichier conanfile.txt :
[requires]
range-v3/0.12.0

[generators]
cmake

# Ensuite dans CMakeLists.txt :
# find_package(range-v3 CONFIG REQUIRED)
# target_link_libraries(my_project PRIVATE range-v3::range-v3 range-v3::meta)

Méthode 3 : Installation manuelle (téléchargement et copie)

Comme la bibliothèque est header-only, vous pouvez simplement la télécharger depuis GitHub et ajouter le chemin include à votre projet.

git clone https://github.com/ericniebler/range-v3.git
# Ensuite, dans les paramètres du compilateur, indiquez :
# -I /chemin/vers/range-v3/include

Méthode 4 : CMake FetchContent (approche moderne)

Cette méthode télécharge automatiquement la bibliothèque lors de la compilation.

include(FetchContent)
FetchContent_Declare(
  range-v3
  GIT_REPOSITORY https://github.com/ericniebler/range-v3.git
  GIT_TAG 0.12.0
)
FetchContent_MakeAvailable(range-v3)

target_link_libraries(my_project PRIVATE range-v3::range-v3 range-v3::meta)

Démarrage rapide : premier exemple

Écrivons un programme simple qui illustre les fonctionnalités de base de range-v3. Nous allons créer un vecteur de nombres, filtrer les pairs, les multiplier par 2 et afficher le résultat.

#include <iostream>
#include <vector>
#include <range/v3/all.hpp>

int main() {
    std::vector<int> numbers = {1, 2, 3, 4, 5, 6, 7, 8,