std::filesystem:: space
|
Défini dans l'en-tête
<filesystem>
|
||
|
std::
filesystem
::
space_info
space
(
const
std::
filesystem
::
path
&
p
)
;
|
(1) | (depuis C++17) |
|
std::
filesystem
::
space_info
space
(
const
std::
filesystem
::
path
&
p,
std:: error_code & ec ) noexcept ; |
(2) | (depuis C++17) |
Détermine les informations sur le système de fichiers sur lequel le chemin
p
est situé, comme par la fonction POSIX
statvfs
.
Remplit et retourne un objet de type
filesystem::space_info
, initialisé à partir des membres de la structure POSIX
struct
statvfs
comme suit :
-
space_info.capacityest défini comme si par f_blocks * f_frsize . -
space_info.freeest défini à f_bfree * f_frsize . -
space_info.availableest défini à f_bavail * f_frsize . - Tout membre qui n'a pas pu être déterminé est défini à static_cast < std:: uintmax_t > ( - 1 ) .
La surcharge non-lancante définit tous les membres à static_cast < std:: uintmax_t > ( - 1 ) en cas d'erreur.
Table des matières |
Paramètres
| p | - | chemin à examiner |
| ec | - | paramètre de sortie pour le rapport d'erreurs dans la surcharge non-lancante |
Valeur de retour
Les informations du système de fichiers (un objet
filesystem::space_info
).
Exceptions
Toute surcharge non marquée
noexcept
peut lever
std::bad_alloc
si l'allocation de mémoire échoue.
Notes
space_info.available
peut être inférieur à
space_info.free
.
Exemple
#include <cstdint> #include <filesystem> #include <iostream> #include <locale> 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); }
Sortie possible :
│ 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
Voir aussi
|
(C++17)
|
informations sur l'espace libre et disponible sur le système de fichiers
(classe) |