std::filesystem::space_info
来自 cppreference.com
< cpp | filesystem
| 定义在头文件 <filesystem> 中 |
||
| struct space_info { std::uintmax_t capacity; |
(自 C++17) | |
表示由 filesystem::space 确定的文件系统信息。
内容 |
[编辑] 成员对象
| capacity |
文件系统的总大小，以字节为单位 (公共成员对象) |
| free |
文件系统上的可用空间，以字节为单位 (公共成员对象) |
| available |
非特权进程可用的可用空间（可能等于或小于 free）(公共成员对象) |
[编辑] 非成员函数
| operator== (C++20) |
比较两个 space_info(函数) |
operator==(std::filesystem::space_info)
| friend bool operator==( const space_info&, const space_info& ) = default; |
(自 C++20) | |
检查两个参数的 capacity、free 和 available 是否分别相等。
此函数对普通的 非限定 或 限定查找不可见，只能通过 参数依赖查找找到，此时 std::filesystem::space_info 是参数的关联类。
!= 运算符是 从 operator== 合成的。
[编辑] 示例
运行此代码
#include <cstdint> #include <filesystem> #include <iostream> std::uintmax_t disk_usage_percent(const std::filesystem::space_info& si, bool is_privileged = false) noexcept { if (constexpr std::uintmax_t X(-1); si.capacity == 0 || si.free == 0 || si.available == 0 || si.capacity == X || si.free == X || si.available == X ) return 100; std::uintmax_t unused_space = si.free, capacity = si.capacity; if (!is_privileged) { const std::uintmax_t privileged_only_space = si.free - si.available; unused_space -= privileged_only_space; capacity -= privileged_only_space; } const std::uintmax_t used_space{capacity - unused_space}; return 100 * used_space / capacity; } void print_disk_space_info(auto const& dirs, int width = 14) { (std::cout << std::left).imbue(std::locale("en_US.UTF-8")); for (const auto s : {"Capacity", "Free", "Available", "Use%", "Dir"}) std::cout << "│ " << std::setw(width) << s << ' '; for (std::cout << '\n'; auto const& dir : dirs) { std::error_code ec; const std::filesystem::space_info si = std::filesystem::space(dir, ec); for (auto x : {si.capacity, si.free, si.available, disk_usage_percent(si)}) std::cout << "│ " << std::setw(width) << static_cast<std::intmax_t>(x) << ' '; std::cout << "│ " << dir << '\n'; } } int main() { const auto dirs = {"/dev/null", "/tmp", "/home", "/proc", "/null"}; print_disk_space_info(dirs); }
可能的输出
│ Capacity │ Free │ Available │ Use% │ Dir │ 84,417,331,200 │ 42,732,986,368 │ 40,156,028,928 │ 50 │ /dev/null │ 84,417,331,200 │ 42,732,986,368 │ 40,156,028,928 │ 50 │ /tmp │ -1 │ -1 │ -1 │ 100 │ /home │ 0 │ 0 │ 0 │ 100 │ /proc │ -1 │ -1 │ -1 │ 100 │ /null
[编辑] 另请参阅
| (C++17) |
确定文件系统上的可用空间 (函数) |
