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