std::filesystem::directory_entry::refresh

void refresh();	(1)	(since C++17)
void refresh( std::error_code& ec ) noexcept;	(2)	(since C++17)

Проверяет объект файловой системы, на который ссылается эта запись каталога, и сохраняет его атрибуты для извлечения с помощью status, exists, is_regular_file и других методов доступа к статусу.

Если произошла ошибка, значение любых кэшированных атрибутов является неопределённым.

Параметры

параметр вывода для отчёта об ошибках в варианте перегрузки без исключений

Возвращаемое значение

(пустое)

Исключения

Любая перегрузка, не помеченная как noexcept, может вызвать std::bad_alloc, если произошла ошибка выделения памяти.

1) Выбрасывает std::filesystem::filesystem_error при ошибках в работе с системными API, сконструированный с p в качестве первого аргумента пути и кодом ошибки системного API в качестве аргумента кода ошибки.

2) Устанавливает параметр std::error_code& в код ошибки системного API, если вызов системного API завершился с ошибкой, и выполняет ec.clear() при отсутствии ошибок.

Примечания

Многие системные API низкого уровня для обхода каталогов извлекают атрибуты файла вместе со следующей записью каталога. Конструкторы и не-const-члены std::filesystem::directory_iterator сохраняют эти атрибуты, если таковые имеются, в указанном std::filesystem::directory_entry без вызова directory_entry::refresh, что позволяет проверить атрибуты записей каталога по мере их перебора без дополнительных системных вызовов.

Пример

См. также

statussymlink_status	статус файла, обозначенного этой записью каталога; статус файла/символической ссылки, обозначенной этой записью каталога (публичный член-функция)
exists	проверяет, ссылается ли запись каталога на существующий объект файловой системы (публичный член-функция)
is_block_file	проверяет, ссылается ли запись каталога на блочное устройство (публичный член-функция)
is_character_file	проверяет, ссылается ли запись каталога на символьное устройство (публичный член-функция)
is_directory	проверяет, ссылается ли запись каталога на каталог (публичный член-функция)
is_fifo	проверяет, ссылается ли запись каталога на именованную трубу (публичный член-функция)
is_other	проверяет, ссылается ли запись каталога на другой файл (публичный член-функция)
is_regular_file	проверяет, ссылается ли запись каталога на обычный файл (публичный член-функция)
is_socket	проверяет, ссылается ли запись каталога на именованный сокет IPC (публичный член-функция)
is_symlink	проверяет, ссылается ли запись каталога на символическую ссылку (публичный член-функция)
file_size	возвращает размер файла, на который ссылается запись каталога (публичный член-функция)
hard_link_count	возвращает количество жёстких ссылок, ссылающихся на файл, на который ссылается запись каталога (публичный член-функция)
last_write_time	получает время последнего изменения данных файла, на который ссылается запись каталога (публичный член-функция)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/filesystem/directory_entry/refresh