operator==,!=,<,<=,>,>=,<=>(std::filesystem::path)

 

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

 

friend bool operator==( const path& lhs, const path& rhs ) noexcept;	(1)	(desde C++17)
friend bool operator!=( const path& lhs, const path& rhs ) noexcept;	(2)	(desde C++17) (hasta C++20)
friend bool operator<( const path& lhs, const path& rhs ) noexcept;	(3)	(desde C++17) (hasta C++20)
friend bool operator<=( const path& lhs, const path& rhs ) noexcept;	(4)	(desde C++17) (hasta C++20)
friend bool operator>( const path& lhs, const path& rhs ) noexcept;	(5)	(desde C++17) (hasta C++20)
friend bool operator>=( const path& lhs, const path& rhs ) noexcept;	(6)	(desde C++17) (hasta C++20)
friend std::strong_ordering     operator<=>( const path& lhs, const path& rhs ) noexcept;	(7)	(desde C++20)

Compara dos rutas de acceso lexicográficamente.

1) Verifica si lhs y rhs son iguales. Equivalente a !(lhs < rhs) && !(rhs < lhs).

2) Verifica si lhs y rhs no son iguales. Equivalente a !(lhs == rhs).

3) Verifica si lhs es menor que rhs. Equivalente a lhs.compare(rhs) < 0.

4) Verifica si lhs es menor que o igual a rhs. Equivalente a !(rhs < lhs).

5) Verifica si lhs es mayor que rhs. Equivalente a rhs < lhs.

6) Verifica si lhs es mayor que o igual a rhs. Equivalente a !(lhs < rhs).

7) Obtiene el resultado de la comparación de tres vías de lhs y rhs. Equivalente a lhs.compare(rhs) <=> 0.

Estas funciones no son visibles a una búsqueda no calificada o calificada, y pueden encontrarse solamente mediante la búsqueda dependiente de argumento cuando std::filesystem::path es una clase asociada de los argumentos. Esto evita conversiones no deseadas en la presencia de una directiva using using namespace std::filesystem;.

Los operadores <, <=, >, >=, y != se sintetizan de operator<=> y operator==, respectivamente.

(desde C++20)

Parámetros

lhs, rhs

-

Las rutas de acceso a comparar.

Valor de retorno

1-6) true si la comparación correspondiente produce, false de lo contrario.

7) std::strong_ordering::less si lhs es menor que rhs, de lo contrario std::strong_ordering::greater si rhs es menor que lhs, de lo contrario std::strong_ordering::equal.

Notas

La igualdad de rutas de acceso y la equivalencia tienen semánticas diferentes.

En el caso de igualdad, según lo determinado por operator==, solo se comparan las representaciones léxicas. Por lo tanto, path("a") == path("b") nunca es true.

En el caso de equivalencia, según lo determinado por std::filesystem::equivalent(), se verifica si dos rutas se resuelven en el mismo objeto del sistema de archivos. Por lo tanto equivalent("a", "b") devolverá true si las rutas se resuelven en el mismo archivo.

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 3065	C++17	Se admitía la comparación de todo lo que fuera convertible a path en la presencia de una directiva using.	La comparación se hizo friend oculto.

Véase también

compare	Compara las representaciones lexicográficas de dos rutas de acceso lexicográficamente. (función miembro pública)
equivalent (C++17)	Verifica si dos rutas de acceso se refieren al mismo objeto de sistema de archivos. (función)