Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::filesystem::path: representação lexical de um caminho

std::filesystem::path guarda sintaxe e elementos de um caminho, mas não verifica por si se um objeto existe ou é válido.

Versão: C++23

Sintaxe

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 nome de raiz opcional, diretório raiz opcional e uma sequência de nomes. O value_type, formato nativo e preferred_separator dependem da plataforma; generic_string() usa o separador portátil /.

std::filesystem::path::empty testa se o caminho está vazio, enquanto std::filesystem::path::is_absolute o classifica pelas regras do sistema operativo; nenhuma consulta o sistema de ficheiros. std::filesystem::path::begin inicia a iteração dos elementos e std::filesystem::path::generic_string serializa o formato genérico com /. std::filesystem::path::lexically_normal normaliza a sintaxe; std::filesystem::path::lexically_relative calcula uma forma puramente lexical relativamente a uma base e pode devolver um caminho vazio para raízes ou formas absoluta/relativa incompatíveis.

A grafia de âmbito std::filesystem::path::operator/ representa a obrigação de composição, mas em C++23 não é um membro: a interface real é o não membro std::filesystem::operator/, equivalente a path(lhs) /= rhs. Não se deve inferir daí um alias membro.

O operador / compõe elementos respeitando regras de raiz e separadores, enquanto operator+= apenas concatena carateres. O exemplo constrói logs/2026/run.txt e imprime nome, extensão e pai logs/2026 no formato genérico.

É uma classe lexical: o caminho pode não existir, ser inválido para o anfitrião ou resolver-se de modo diferente relativamente ao diretório atual. lexically_normal remove componentes sintaticamente e não segue links. operator== compara representações lexicais, não identidade de ficheiros; para esta usa filesystem::equivalent em objetos existentes.

Exemplos

#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

Fontes