CKTIS / C++
std::filesystem::path: representación léxica de una ruta
std::filesystem::path guarda la sintaxis y los elementos de una ruta, pero no comprueba por sí mismo si un objeto existe o es válido.
Versión: C++23
Sintaxis
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> representa un nombre de raíz opcional, directorio raíz opcional y una secuencia de nombres. Su value_type, formato nativo y preferred_separator dependen de la plataforma; generic_string() usa el separador portable /.
std::filesystem::path::empty comprueba si el nombre de ruta está vacío, mientras std::filesystem::path::is_absolute lo clasifica según reglas del sistema operativo; ninguna consulta el sistema de archivos. std::filesystem::path::begin inicia la iteración de elementos y std::filesystem::path::generic_string serializa el formato genérico con /. std::filesystem::path::lexically_normal normaliza la sintaxis; std::filesystem::path::lexically_relative calcula una forma puramente léxica respecto de una base y puede devolver una ruta vacía para raíces o formas absoluta/relativa incompatibles.
La escritura de alcance std::filesystem::path::operator/ representa la obligación de composición, pero no es un miembro en C++23: la interfaz real es el no miembro std::filesystem::operator/, equivalente a path(lhs) /= rhs. No debe inferirse de ella un alias miembro.
El operador / compone elementos respetando reglas de raíz y separadores, mientras operator+= solo concatena caracteres. El ejemplo construye logs/2026/run.txt e imprime el nombre, la extensión y el padre logs/2026 en formato genérico.
Es una clase léxica: la ruta puede no existir, ser inválida para el host o resolverse de otro modo respecto al directorio actual. lexically_normal elimina componentes sintácticamente y no sigue enlaces. operator== compara representaciones léxicas, no identidad de archivos; para esta usa filesystem::equivalent sobre objetos existentes.
Ejemplos
#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';
}
Resultado
run.txt .txt logs/2026
std::filesystem::path → run.txt .txt logs/2026