std::filesystem::create_symlink, std::filesystem::create_directory_symlink

 

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

 

Definido en el archivo de encabezado <filesystem>
void create_symlink(conststd::filesystem::path& target,                      conststd::filesystem::path& link ); void create_symlink(conststd::filesystem::path& target,                      conststd::filesystem::path& link,                      std::error_code& ec )noexcept;	(1)	(desde C++17)
void create_directory_symlink(conststd::filesystem::path& target,                                conststd::filesystem::path& link ); void create_directory_symlink(conststd::filesystem::path& target,                                conststd::filesystem::path& link,                                std::error_code& ec )noexcept;	(2)	(desde C++17)

Crea un enlace simbólico link con su objetivo establecido en target como si fuera por la función symlink() de POSIX: el nombre de la ruta de acceso target puede ser inválido o no existir.

Algunos sistemas operativos requieren la creación de enlaces simbólicos para identificar que el enlace sea para un directorio. El código portátil debe usar (2) para crear enlaces simbólicos de directorios en lugar de (1), aunque no hay distinción en los sistemas POSIX.

Parámetros

target	-	La ruta de acceso a la que apunta el enlace simbólico; no tiene que existir.
link	-	La ruta de acceso del nuevo enlace simbólico.
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 target como el primer argumento de la ruta de acceso, link como el segundo 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.

Notas

Algunos sistemas operativos no admiten enlaces simbólicos en lo absoluto o los admiten solo para archivos regulares.

Algunos sistemas de archivos no admiten enlaces simbólicos independientemente del sistema operativo: por ejemplo, el sistema de archivos FAT utilizado en tarjetas de memoria y unidades flash.

Igual que un enlace físico, un enlace simbólico permite que un archivo tenga varios nombres lógicos. La presencia de un enlace físico garantiza la existencia de un archivo, incluso después de que se haya eliminado el nombre original. Un enlace simbólico no ofrece tal seguridad; de hecho, el archivo nombrado por el argumento target no necesita existir cuando se crea el enlace. Un enlace simbólico puede cruzar los límites del sistema de archivos.

Ejemplo

Ejecuta este código

#include <iostream>#include <filesystem>#include <cassert>namespace fs = std::filesystem;   int main(){ fs::create_directories("entorno_aislado/subdir"); fs::create_symlink("objetivo", "entorno_aislado/sym1"); fs::create_directory_symlink("subdir", "entorno_aislado/sym2");   for(auto it = fs::directory_iterator("entorno_aislado"); it != fs::directory_iterator();++it)if(is_symlink(it->symlink_status()))std::cout<<*it <<"->"<< read_symlink(*it)<<'\n';   assert(std::filesystem::equivalent("entorno_aislado/sym2", "entorno_aislado/subdir")); fs::remove_all("entorno_aislado");}

Posible salida:

"entorno_aislado/sym1"->"objetivo" "entorno_aislado/sym2"->"subdir"

Véase también

statussymlink_status (C++17)(C++17)	Determina los atributos de archivo. Determina los atributos de archivo, verificando el objetivo del enlace simbólico. (función)
read_symlink (C++17)	Obtiene el objetivo de un enlace simbólico. (función)
create_hard_link (C++17)	Crea un enlace físico. (función)