std::filesystem::directory_entry::refresh
void refresh(); void refresh(std::error_code& ec )noexcept; | (desde C++17) | |
Examina el objeto del sistema de archivos al que se refiere esta entrada de directorio y almacena sus atributos para su recuperación con status
, exists
, is_regular_file
, y otros captadores de estado.
Si ocurre un error, el valor de cualquier atributo en caché no está especificado.
Contenido |
[editar]Parámetros
ec | - | El parámetro de salida para informe de errores en la sobrecarga que no lanza excepciones. |
[editar]Valor de retorno
(Ninguno)
[editar]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.
[editar]Notas
Muchas API de bajo nivel del sistema operativo para el recorrido de directorios recuperan atributos de archivo junto con la siguiente entrada de directorio. Los constructores y las funciones miembro no const de std::filesystem::directory_iterator almacenan estos atributos, si los hay, en el objeto std::filesystem::directory_entry al que se apunta sin llamar a directory_entry::refresh, lo que permite examinar los atributos de las entradas de directorio a medida que se recorren, sin realizar llamadas adicionales al sistema.
[editar]Ejemplo
Esta sección está incompleta Razón: sin ejemplo |
[editar]Véase también
Estado del archivo designado por esta entrada de directorio. symlink_status del archivo designado por esta entrada de directorio. (función miembro pública) | |
Verifica si la entrada de directorio se refiere a un objeto existente en el sistema de archivos. (función miembro pública) | |
Verifica si la entrada de directorio se refiere a un dispositivo orientado a bloques. (función miembro pública) | |
Verifica si la entrada de directorio se refiere a un dispositivo orientado a caracteres. (función miembro pública) | |
Verifica si la entrada de directorio se refiere a un directorio. (función miembro pública) | |
Verifica si la entrada de directorio se refiere a un pipe denominado. (función miembro pública) | |
Verifica si la entrada de directorio se refiere a otro archivo. (función miembro pública) | |
Verifica si la entrada de directorio se refiere a un archivo regular. (función miembro pública) | |
Verifica si la entrada de directorio se refiere a un socket IPC denominado. (función miembro pública) | |
Verifica si la entrada de directorio se refiere a un enlace simbólico. (función miembro pública) | |
Devuelve el tamaño del archivo al que se refiere la entrada de directorio. (función miembro pública) | |
Devuelve el número de enlaces físicos que se refieren al archivo al que se refiere la entrada de directorio. (función miembro pública) | |
Obtiene o establece la fecha y la hora de la última modificación de datos del archivo al que se refiere la entrada de directorio. (función miembro pública) |