Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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

Fuentes