Filesystem library

Incorporado en ISO C++ La funcionalidad descrita en esta página fue incorporada al estándar principal de ISO C++ a partir de 3/2016; consulte la biblioteca filesystem (desde C++17)

La biblioteca Filesystem, ISO/IEC TS 18822:2015, proporciona facilidades para realizar operaciones en sistemas de archivos y sus componentes, tales como rutas, archivos regulares y directorios.

Esta biblioteca es una especificación técnica opcional y puede no estar disponible si el sistema de archivos jerárquico no es accesible para la implementación, o si no proporciona las capacidades necesarias. Algunas características pueden no estar disponibles si no son compatibles con el sistema de archivos subyacente (por ejemplo, el sistema de archivos FAT no tiene enlaces físicos, enlaces simbólicos y otras características).

El comportamiento es undefined si las llamadas a funciones en esta biblioteca introducen una file system race , es decir, cuando múltiples hilos, procesos o computadoras intercalan acceso y modificación al mismo objeto en un sistema de archivos.

Esta biblioteca está basada directamente en boost.filesystem , que actualmente está disponible en más compiladores y plataformas que esta especificación técnica experimental.

Contenidos 1 Definiciones globales de la biblioteca 2 Clases 3 Funciones no miembro 3.1 Tipos de archivo 4 Véase también

Definiciones de toda la biblioteca

• file : un objeto del sistema de archivos que contiene datos, puede ser escrito, leído, o ambas cosas. Los archivos tienen nombres, atributos, uno de los cuales es el tipo de archivo:

• directorio : un archivo que actúa como contenedor de entradas de directorio, las cuales identifican otros archivos (algunos de los cuales pueden ser otros directorios anidados). Al discutir un archivo particular, el directorio en el que aparece como entrada es su directorio padre . El directorio padre puede representarse mediante la ruta relativa ".." .
• enlace físico : una entrada de directorio que asocia un nombre con un archivo existente. Si se admiten múltiples enlaces físicos, el archivo se elimina después de que se elimine el último enlace físico a él.
• enlace simbólico : una entrada de directorio que asocia un nombre con una ruta, que puede existir o no.
• archivo regular : un archivo que no es uno de los otros tipos de archivo.

• nombre de archivo : una cadena de caracteres que nombra un archivo. Los caracteres permitidos, sensibilidad a mayúsculas, longitud máxima y los nombres no permitidos están definidos por la implementación. Los nombres . (punto) y .. (punto-punto) tienen significado especial a nivel de biblioteca.
• ruta : secuencia de elementos que identifica un archivo. Comienza con un root-name opcional (ej. "C:" o "//server" ), seguido por un root-directory opcional (ej. "/" en Unix), seguido por una secuencia de cero o más nombres de archivo (todos excepto el último deben ser directorios o enlaces a directorios). El formato nativo (ej. qué caracteres se usan como separadores) y la codificación de caracteres de la representación en cadena de una ruta (el pathname ) está definido por la implementación; esta biblioteca proporciona una representación portable de rutas.

• absolute path : una ruta que identifica sin ambigüedad la ubicación de un archivo.
• canonical path : una ruta absoluta que no incluye enlaces simbólicos, "." o ".." elementos.
• relative path : una ruta que identifica un archivo relativo a alguna ubicación en el sistema de archivos. Los nombres de ruta especiales . (punto, "directorio actual") y .. (punto-punto, "directorio padre") son rutas relativas.

Clases

path	representa una ruta (clase)
filesystem_error	una excepción lanzada en errores del sistema de archivos (clase)
directory_entry	una entrada de directorio (clase)
directory_iterator	un iterador a los contenidos del directorio (clase)
recursive_directory_iterator	un iterador a los contenidos de un directorio y sus subdirectorios (clase)
file_status	representa el tipo de archivo y permisos (clase)
space_info	información sobre espacio libre y disponible en el sistema de archivos (clase)
file_type	el tipo de un archivo (enum)
perms	identifica permisos del sistema de archivos (enum)
copy_options	especifica semántica de operaciones de copia (enum)
directory_options	opciones para iterar contenidos de directorio (enum)
file_time_type	representa valores de tiempo de archivo (typedef)

Funciones no miembro

absolute system_complete	compone una ruta absoluta convierte una ruta en una ruta absoluta replicando el comportamiento específico del SO (función)
canonical	compone una ruta canónica (función)
copy	copia archivos o directorios (función)
copy_file	copia contenidos de archivo (función)
copy_symlink	copia un enlace simbólico (función)
create_directory create_directories	crea un nuevo directorio (función)
create_hard_link	crea un enlace físico (función)
create_symlink create_directory_symlink	crea un enlace simbólico (función)
current_path	devolver directorio de trabajo actual (función)
exists	verifica si la ruta hace referencia a un objeto del sistema de archivos existente (función)
equivalent	verifica si dos rutas se refieren al mismo objeto del sistema de archivos (función)
file_size	devuelve el tamaño de un archivo (función)
hard_link_count	devuelve el número de enlaces físicos que referencian al archivo específico (función)
last_write_time	obtiene o establece la hora de la última modificación de datos (función)
permissions	modifica los permisos de acceso al archivo (función)
read_symlink	obtiene el destino de un enlace simbólico (función)
remove remove_all	elimina un archivo o directorio vacío elimina un archivo o directorio y todo su contenido, recursivamente (función)
rename	mueve o renombra un archivo o directorio (función)
resize_file	cambia el tamaño de un archivo regular mediante truncamiento o relleno con ceros (función)
space	determina el espacio libre disponible en el sistema de archivos (función)
status symlink_status	determina los atributos del archivo determina los atributos del archivo, verificando el destino del enlace simbólico (función)
temp_directory_path	devuelve un directorio adecuado para archivos temporales (función)
Tipos de archivo
is_block_file	comprueba si la ruta dada se refiere a un dispositivo de bloques (función)
is_character_file	verifica si la ruta dada se refiere a un dispositivo de caracteres (función)
is_directory	comprueba si la ruta dada se refiere a un directorio (función)
is_empty	verifica si la ruta dada hace referencia a un archivo o directorio vacío (función)
is_fifo	comprueba si la ruta dada se refiere a una tubería con nombre (función)
is_other	comprueba si el argumento se refiere a un otro archivo (función)
is_regular_file	verifica si el argumento se refiere a un archivo regular (función)
is_socket	comprueba si el argumento se refiere a un socket IPC con nombre (función)
is_symlink	verifica si el argumento se refiere a un enlace simbólico (función)
status_known	verifica si el estado del archivo es conocido (función)

Véase también

Documentación de C++ para Biblioteca del sistema de archivos (C++17)