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.
Parámetros
| 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 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.
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.
Ejemplo
| Esta sección está incompleta Razón: sin ejemplo |
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) |