std::filesystem::directory_entry::replace_filename

 

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::directory_entry

Funciones miembro

directory_entry::directory_entry

Modificadores

directory_entry::operator=

directory_entry::assign

directory_entry::replace_filename

directory_entry::refresh

Observadores

directory_entry::pathdirectory_entry::operator const path&

directory_entry::exists

directory_entry::is_block_file

directory_entry::is_character_file

directory_entry::is_directory

directory_entry::is_fifo

directory_entry::is_other

directory_entry::is_regular_file

directory_entry::is_socket

directory_entry::is_symlink

directory_entry::file_size

directory_entry::hard_link_count

directory_entry::last_write_time

directory_entry::statusdirectory_entry::symlink_status

directory_entry::operator==directory_entry::operator!=directory_entry::operator<directory_entry::operator>directory_entry::operator<=directory_entry::operator>=directory_entry::operator<=> (hasta C++20)(hasta C++20)(hasta C++20)(hasta C++20)(hasta C++20)(C++20)

Funciones no miembro

operator<<

 

void replace_filename(conststd::filesystem::path& p ); void replace_filename(conststd::filesystem::path& p, std::error_code& ec );		(desde C++17)

Cambia el nombre de archivo de la entrada de directorio.

Efectivamente modifica el miembro de ruta de acceso mediante path.replace_filename(p) y llama a refresh para actualizar los atributos en caché.

Si ocurre un error, el valor de cualquier atributo en caché no está especificado.

Esta función no realiza ningún cambio en el sistema de archivos.

Parámetros

p	-	La ruta de acceso a añadir a la ruta de acceso padre de la ruta almacenada actualmente.
ec	-	El parámetro de salida para informe de errores en la sobrecarga que no lanza excepciones.

Valor de retorno

(Ninguno)

Excepciones

La sobrecarga que no toma un parámetro std::error_code& lanza filesystem::filesystem_error en los errores de la API del sistema operativo subyacente, construido con p como el primer argumento de la ruta de acceso y el código de error del sistema operativo como el argumento del código de error. La sobrecarga que toma un parámetro std::error_code& lo establece en el código de error de la API del sistema operativo si una llamada a la API del sistema operativo falla, y ejecuta ec.clear() si no ocurren errores. Cualquier sobrecarga que no está marcada con noexcept puede lanzar std::bad_alloc si la asignación de memoria falla.

Ejemplo

Ejecuta este código

#include <iostream>#include <filesystem>   int main(){namespace fs = std::filesystem;{ fs::directory_entry entrada{"omega"};std::cout<< entrada <<'\n'; entrada.replace_filename("alpha");std::cout<< entrada <<'\n';}{ fs::directory_entry entrada{"/omega/"};std::cout<< entrada <<'\n'; entrada.replace_filename("alpha");std::cout<< entrada <<'\n';}}

Salida:

"omega" "alpha" "/omega/" "/omega/alpha"

Véase también

assign	Asigna el contenido. (función miembro pública)
replace_filename	Reemplaza el último componente de la ruta de acceso con otra ruta de acceso. (función miembro pública de std::filesystem::path)