std::filesystem::path::operator=

 

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

 

<tbody> </tbody>

path& operator=( const path& p );	(1)	(desde C++17)
path& operator=( path&& p ) noexcept;	(2)	(desde C++17)
path& operator=( string_type&& source );	(3)	(desde C++17)
template< class Source > path& operator=( const Source& source );	(4)	(desde C++17)

1) Reemplaza el contenido de *this con un nombre de ruta de acceso cuyas representaciones, tanto en formato nativo como genérico, son iguales a las de p.

2) Reemplaza el contenido de *this con un nombre de ruta de acceso cuyas representaciones, tanto en formato nativo como genérico, son iguales a las de p, posiblemente utilizando la semántica de movimiento: p se deja en un estado válido pero no especificado.

3) Reemplaza el contenido de *this con un nuevo valor de ruta de acceso del formato detectado en source, que se deja en un estado válido pero no especificado. Equivalente a assign(std::move(source)).

4) Reemplaza el contenido de *this con un nuevo valor de ruta de acceso del formato detectado en source como si fuera por la sobrecarga (4) del constructor de ruta de acceso. Equivalente a assign(source).

(4) participa en la resolución de sobrecargas solo si Source y path no son el mismo tipo, y ya sea que:

• Source es una especialización de std::basic_string o std::basic_string_view, o
• std::iterator_traits<std::decay_t<Source>>::value_type es válido y denota una codificación para un tipo carácter, posiblemente calificado const (char, char8_t, (desde C++20)char16_t, char32_t, o wchar_t).

Parámetros

p	-	Una ruta de acceso a asignar.
source	-	Un objeto std::basic_string, std::basic_string_view, o puntero a una cadena de caracteres o cadena de caracteres anchos, o un iterador de entrada que apunta a una secuencia de caracteres o caracteres anchos. El tipo carácter debe ser uno de char, char8_t, (desde C++20)char16_t, char32_t, wchar_t

Valor de retorno

*this

Ejemplo

Ejecuta este código

#include <filesystem>
namespace fs = std::filesystem;
int main()
{
    fs::path p = "C:/users/abcdef/AppData/Local";
    p = p / "Temp"; // asignación por movimiento
    const wchar_t* wstr = L"D:/猫.txt";
    p = wstr; // asignación desde una fuente
}

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 3244	C++17	Faltaba la restricción que Source no puede ser de tipo path.	Se agregó.

Véase también

assign	Asigna el contenido. (función miembro pública)
(constructor)	Construye una ruta de acceso. (función miembro pública)