std::filesystem::directory_entry:: refresh
|
void
refresh
(
)
;
|
(1) | (начиная с C++17) |
|
void
refresh
(
std::
error_code
&
ec
)
noexcept
;
|
(2) | (начиная с C++17) |
Исследует объект файловой системы, на который ссылается данная запись каталога, и сохраняет его атрибуты для последующего получения с помощью
status
,
exists
,
is_regular_file
и других методов доступа к состоянию.
Если возникает ошибка, значение любых кэшированных атрибутов не определено.
Содержание |
Параметры
| ec | - | выходной параметр для сообщения об ошибках в непорождающей исключения перегрузке |
Возвращаемое значение
(нет)
Исключения
Любая перегрузка, не помеченная
noexcept
, может выбрасывать
std::bad_alloc
при неудачном выделении памяти.
Примечания
Многие низкоуровневые API операционных систем для обхода каталогов получают атрибуты файлов вместе со следующей записью каталога. Конструкторы и неконстантные функции-члены std::filesystem::directory_iterator сохраняют эти атрибуты, если они есть, в указываемый std::filesystem::directory_entry без вызова directory_entry::refresh , что позволяет изучать атрибуты записей каталога во время итерации по ним без дополнительных системных вызовов.
Пример
|
Этот раздел не завершён
Причина: отсутствует пример |
Смотрите также
|
статус файла, указанного этой записью каталога;
статус файла/символической ссылки, указанной этой записью каталога (публичная функция-член) |
|
|
проверяет, ссылается ли запись каталога на существующий объект файловой системы
(публичная функция-член) |
|
|
проверяет, ссылается ли запись каталога на блочное устройство
(публичная функция-член) |
|
|
проверяет, ссылается ли запись каталога на символьное устройство
(публичная функция-член) |
|
|
проверяет, ссылается ли запись каталога на каталог
(публичная функция-член) |
|
|
проверяет, ссылается ли запись каталога на именованный канал
(публичная функция-член) |
|
|
проверяет, ссылается ли запись каталога на
другой
файл
(публичная функция-член) |
|
|
проверяет, ссылается ли запись каталога на обычный файл
(публичная функция-член) |
|
|
проверяет, ссылается ли запись каталога на именованный IPC-сокет
(публичная функция-член) |
|
|
проверяет, ссылается ли запись каталога на символическую ссылку
(публичная функция-член) |
|
|
возвращает размер файла, на который ссылается запись каталога
(публичная функция-член) |
|
|
возвращает количество жёстких ссылок, указывающих на файл, на который ссылается запись каталога
(публичная функция-член) |
|
|
получает время последнего изменения данных файла, на который ссылается запись каталога
(публичная функция-член) |