std::filesystem::path::replace_extension

 

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& replace_extension(const path& replacement = path());		(desde C++17)

Reemplaza la extensión con replacement o la elimina cuando se utiliza el valor por defecto de replacement.

Primero si la ruta de acceso tiene una extensión de tipo extension(), se elimina de la vista de formato genérico del nombre de ruta de acceso.

Luego se añade un carácter punto, a la vista de formato genérico del nombre de ruta de acceso, si replacement no está vacía y no comienza con el carácter punto.

Enotnces se añade replacement como si fuera por operator+=(replacement).

Parámetros

replacement

-

La extensión con la que reemplazar.

Valor de retorno

*this

Excepciones

Puede lanzar excepciones definidas por la implementación.

Notas

El tipo de replacement es std::filesystem::path aunque no está destinado a representar un objeto en el sistema de archivos para tomar en cuenta la codificación de caracteres del sistema de archivos.

Ejemplo

Ejecuta este código

#include <filesystem>#include <iomanip>#include <iostream>#include <utility>namespace fs = std::filesystem;   int main(){std::cout<<"Ruta: Ext: Resultado:\n"<<std::left;for(constauto&[path, extension]:{std::make_pair("/foo/bar.jpg", ".png"), std::make_pair("/foo/bar.jpg", "png"), std::make_pair("/foo/bar.jpg", "."), std::make_pair("/foo/bar.jpg", ""), std::make_pair("/foo/bar." , "png"), std::make_pair("/foo/bar" , ".png"), std::make_pair("/foo/bar" , "png"), std::make_pair("/foo/bar" , "."), std::make_pair("/foo/bar" , ""), std::make_pair("/foo/." , ".png"), std::make_pair("/foo/." , "png"), std::make_pair("/foo/." , "."), std::make_pair("/foo/." , ""), std::make_pair("/foo/" , ".png"), std::make_pair("/foo/" , "png"), }){ fs::path p = path, e = extension;std::cout<<std::setw(18)<< p <<std::setw(11)<< e; p.replace_extension(e);std::cout<< p <<'\n';}}

Salida:

Ruta: Ext: Resultado: "/foo/bar.jpg" ".png" "/foo/bar.png" "/foo/bar.jpg" "png" "/foo/bar.png" "/foo/bar.jpg" "." "/foo/bar." "/foo/bar.jpg" "" "/foo/bar" "/foo/bar." "png" "/foo/bar.png" "/foo/bar" ".png" "/foo/bar.png" "/foo/bar" "png" "/foo/bar.png" "/foo/bar" "." "/foo/bar." "/foo/bar" "" "/foo/bar" "/foo/." ".png" "/foo/..png" "/foo/." "png" "/foo/..png" "/foo/." "." "/foo/.." "/foo/." "" "/foo/." "/foo/" ".png" "/foo/.png" "/foo/" "png" "/foo/.png"

Véase también

extension	Devuelve el componente de extensión de archivo de la ruta de acceso. (función miembro pública)
filename	Devuelve el componente de nombre de archivo de la ruta de acceso. (función miembro pública)
stem	Devuelve el componente del pie de la ruta de acceso (el nombre de archivo sin la extensión final). (función miembro pública)
has_extension	Verifica si el elemento de ruta de acceso correspondiente no está vacío. (función miembro pública)