std::filesystem::path::lexically_normal, std::filesystem::path::lexically_relative, std::filesystem::path::lexically_proximate

 

C++

Apoyo de compiladores

Implementaciones independientes y albergadas

Lenguaje

Biblioteca estándar

Encabezados de la biblioteca estándar

Requisitos denominados

Macros de prueba de característica (C++20)

Biblioteca de apoyo del lenguaje

Biblioteca de conceptos (C++20)

Biblioteca de diagnósticos

Biblioteca de gestión de memoria

Biblioteca de metaprogramación (C++11)

Biblioteca de servicios generales

Biblioteca de contenedores

Biblioteca de iteradores

Biblioteca de rangos (C++20)

Biblioteca de algoritmos

Biblioteca de cadenas

Biblioteca de procesamiento de texto

Biblioteca numérica

Biblioteca de fecha y hora

Biblioteca de entrada/salida

Biblioteca del sistema de archivos (C++17)

Biblioteca de apoyo de concurrencia (C++11)

Biblioteca de apoyo de ejecución (C++26)

Especificaciones técnicas

Índice de símbolos

Bibliotecas externas

 

Biblioteca del sistema de archivos

Clases
filesystem::path filesystem::filesystem_error filesystem::directory_entry filesystem::directory_iterator filesystem::recursive_directory_iterator filesystem::file_status	filesystem::space_info filesystem::file_type filesystem::perms filesystem::perm_options filesystem::copy_options filesystem::directory_options filesystem::file_time_type
Funciones
filesystem::absolute filesystem::canonicalfilesystem::weakly_canonical filesystem::relativefilesystem::proximate filesystem::copy filesystem::copy_file filesystem::copy_symlink filesystem::create_directory filesystem::create_directories filesystem::create_hard_link filesystem::create_symlink filesystem::create_directory_symlink filesystem::current_path	filesystem::exists filesystem::equivalent filesystem::file_size filesystem::hard_link_count filesystem::last_write_time filesystem::permissions filesystem::read_symlink filesystem::remove filesystem::remove_all filesystem::rename filesystem::resize_file filesystem::space filesystem::status filesystem::symlink_status filesystem::temp_directory_path
Tipos de archivo
filesystem::is_block_file filesystem::is_character_file filesystem::is_directory filesystem::is_empty filesystem::status_known	filesystem::is_fifo filesystem::is_other filesystem::is_regular_file filesystem::is_socket filesystem::is_symlink

 

std::filesystem::path

Constantes
path::native_formatpath::generic_formatpath::auto_format
Funciones miembro
path::path path::~path path::operator= path::assign path::appendpath::operator /= path::concatpath::operator += path::clear path::make_preferred path::remove_filename path::replace_filename path::replace_extension      path::swap path::compare path::beginpath::end	path::c_strpath::nativepath::operator string_type path::stringpath::u8stringpath::u16stringpath::u32stringpath::wstring path::generic_stringpath::generic_u8stringpath::generic_u16stringpath::generic_u32stringpath::generic_wstring path::lexically_normalpath::lexically_relativepath::lexically_proximate
Descomposición de ruta de acceso
path::root_name path::root_directory path::root_path path::relative_path path::parent_path path::filename path::stem path::extension path::empty	path::has_root_pathpath::has_root_namepath::has_root_directorypath::has_relative_pathpath::has_parent_pathpath::has_filenamepath::has_stempath::has_extension path::is_absolutepath::is_relative
Funciones no miembro
operator==operator!=operator<operator<=operator>operator>=operator<=> (hasta C++20)(hasta C++20)(hasta C++20)(hasta C++20)(hasta C++20)(C++20)	operator/ operator<<operator>> swap(path) hash_value u8path

 

path lexically_normal() const;	(1)	(desde C++17)
path lexically_relative(const path& base) const;	(2)	(desde C++17)
path lexically_proximate(const path& base) const;	(3)	(desde C++17)

1) Devuelve *this convertido a la forma normal en su formato genérico.

2) Devuelve *this hecho relativo a base.

• Primero, si root_name() != base.root_name() es true o is_absolute() != base.is_absolute() es true o (!has_root_directory() && base.has_root_directory()) es true o cualquier nombre de archivo en relative_path() o base.relative_path() puede interpretarse como un nombre-raíz, devuelve una ruta de acceso construida por defecto.
• De lo contrario, primero determina el primer elemento no coincidente de *this y base como si fuera por auto [a, b] = mismatch(begin(), end(), base.begin(), base.end()), entonces

• si a == end() y b == base.end(), devuelve path(".");
• de lo contrario, define N como el número de elementos de nombre de archivo no vacíos que no son ni punto ni punto-punto en [b, base.end()), menos el número de elementos de nombre de archivo punto-punto, si N < 0, devuelve una ruta de acceso construida por defecto.
• de lo contrario, si N = 0 y a == end() || a->empty(), devuelve path(".");
• de lo contrario devuelve un objeto compuesto de

• una ruta de acceso path() construida por defecto, seguida de
• N aplicaciones de operator/=(path("..")), seguida de
• una aplicación de operator/= para cada elemento en el rango semiabierto [a, end()).

3) Si el valor de lexically_relative(base) no es una ruta de acceso vacía, devolverla. De lo contrario devolver *this.

Parámetros

(Ninguno)

Valor de retorno

1) La forma normal de la ruta de acceso.

2) La forma relativa de la ruta de acceso.

3) La forma aproximada de la ruta de acceso.

Excepciones

Puede lanzar excepciones definidas por la implementación.

Notas

Estas conversiones son puramente léxicas. No verifican que las rutas existan, no siguen los enlaces simbólicos y no acceden al sistema de archivos en absoluto. Para contrapartes de seguimiento simbólico de lexically_relative y lexically_proximate, véase relative y proximate.

En Windows, la ruta de acceso devuelta tiene barras invertidas (la barra invertida es el separador de directorio preferido).

En POSIX, ningún nombre de archivo en una ruta de acceso relativa es aceptable como un nombre-raíz.

Ejemplo

Ejecuta este código

#include <iostream>
#include <filesystem>
#include <cassert>
namespace fs = std::filesystem;
 
int main()
{
    assert(fs::path("a/./b/..").lexically_normal() == "a/");
    assert(fs::path("a/.///b/../").lexically_normal() == "a/");
    assert(fs::path("/a/d").lexically_relative("/a/b/c") == "../../d");
    assert(fs::path("/a/b/c").lexically_relative("/a/d") == "../b/c");
    assert(fs::path("a/b/c").lexically_relative("a") == "b/c");
    assert(fs::path("a/b/c").lexically_relative("a/b/c/x/y") == "../..");
    assert(fs::path("a/b/c").lexically_relative("a/b/c") == ".");
    assert(fs::path("a/b").lexically_relative("c/d") == "../../a/b");
    assert(fs::path("a/b").lexically_relative("/a/b") == "");
    assert(fs::path("a/b").lexically_proximate("/a/b") == "a/b");
}

Informes de defectos

Los siguientes informes de defectos de cambio de comportamiento se aplicaron de manera retroactiva a los estándares de C++ publicados anteriormente.

ID	Aplicado a	Comportamiento según lo publicado	Comportamiento correcto
LWG 3070	C++17	Un nombre de archivo que también puede ser un nombre-raíz puede causar resultados sorpresivos.	Se trata como un caso de error.
LWG 3096	C++17	La secuencias "/" y "/." al final se manejan incorrectamente.	Se corrigió el manejo.

Véase también

relativeproximate (C++17)

Compone una ruta de acceso relativa. (función)