Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

std::filesystem::path : représentation lexicale d’un chemin

std::filesystem::path stocke la syntaxe et les éléments d’un chemin sans vérifier lui-même l’existence ou la validité d’un objet du système.

Version : C++23

Syntaxe

class std::filesystem::path {
public:
    using value_type = /* operating-system-dependent */;
    static constexpr value_type preferred_separator = /* operating-system-dependent */;

    bool empty() const noexcept;
    bool is_absolute() const;
    std::string generic_string() const;
    path lexically_normal() const;
    path lexically_relative(const path& base) const;
    iterator begin() const;
};

path std::filesystem::operator/(const path& lhs, const path& rhs);

std::filesystem::path de <filesystem> représente un nom de racine facultatif, un répertoire racine facultatif et une suite de noms de fichiers. Son value_type, son format natif et preferred_separator dépendent de la plateforme ; generic_string() utilise le séparateur portable /.

std::filesystem::path::empty teste si le chemin est vide, tandis que std::filesystem::path::is_absolute le classe selon les règles du système ; aucune n’interroge le système de fichiers. std::filesystem::path::begin commence l’itération sur les éléments et std::filesystem::path::generic_string sérialise le format générique avec /. std::filesystem::path::lexically_normal normalise la syntaxe ; std::filesystem::path::lexically_relative calcule une forme purement lexicale par rapport à une base et peut renvoyer un chemin vide pour des racines ou formes absolue/relative incompatibles.

L’écriture de portée std::filesystem::path::operator/ désigne l’obligation de composition, mais ce n’est pas un membre en C++23 : l’interface réelle est le non-membre std::filesystem::operator/, équivalent à path(lhs) /= rhs. Il ne faut pas en déduire un alias membre.

L’opérateur / compose les éléments en respectant racines et séparateurs, tandis que operator+= concatène seulement des caractères. L’exemple construit logs/2026/run.txt et affiche le nom, l’extension et le parent logs/2026 au format générique.

La classe est lexicale : le chemin peut ne pas exister, être invalide pour l’hôte ou se résoudre différemment depuis le répertoire courant. lexically_normal retire des composants syntaxiquement sans suivre les liens. operator== compare les représentations lexicales, non l’identité des fichiers ; utilisez filesystem::equivalent sur des objets existants pour celle-ci.

Exemples

#include <filesystem>
#include <iostream>

int main() {
    namespace fs = std::filesystem;
    const fs::path value = fs::path{"logs"} / "2026" / "run.txt";
    std::cout << value.filename().string() << ' '
              << value.extension().string() << ' '
              << value.parent_path().generic_string() << '\n';
}

Résultat

run.txt .txt logs/2026

std::filesystem::path → run.txt .txt logs/2026

Sources