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套接字
(公开成员函数) |
|
|
检查目录项是否指向符号链接
(公开成员函数) |
|
|
返回目录项所指文件的大小
(公开成员函数) |
|
|
返回指向目录项所指文件的硬链接数量
(公开成员函数) |
|
|
获取目录项所指文件的最后数据修改时间
(公开成员函数) |