std::filesystem:: space
|
Definido en el encabezado
<filesystem>
|
||
|
std::
filesystem
::
space_info
space
(
const
std::
filesystem
::
path
&
p
)
;
|
(1) | (desde C++17) |
|
std::
filesystem
::
space_info
space
(
const
std::
filesystem
::
path
&
p,
std:: error_code & ec ) noexcept ; |
(2) | (desde C++17) |
Determina la información sobre el sistema de archivos en el que se encuentra la ruta
p
, como si fuera mediante POSIX
statvfs
.
Rellena y retorna un objeto de tipo
filesystem::space_info
, configurado a partir de los miembros de la estructura POSIX
struct
statvfs
de la siguiente manera:
-
space_info.capacityse establece como si fuera mediante f_blocks * f_frsize . -
space_info.freese establece en f_bfree * f_frsize . -
space_info.availablese establece en f_bavail * f_frsize . - Cualquier miembro que no se pudo determinar se establece en static_cast < std:: uintmax_t > ( - 1 ) .
La sobrecarga que no lanza excepciones establece todos los miembros a static_cast < std:: uintmax_t > ( - 1 ) en caso de error.
Contenidos |
Parámetros
| p | - | ruta a examinar |
| ec | - | parámetro de salida para reporte de errores en la sobrecarga no lanzadora |
Valor de retorno
La información del sistema de archivos (un
filesystem::space_info
objeto).
Excepciones
Cualquier sobrecarga no marcada como
noexcept
puede lanzar
std::bad_alloc
si la asignación de memoria falla.
Notas
space_info.available
puede ser menor que
space_info.free
.
Ejemplo
#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); }
Salida posible:
│ 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
Véase también
|
(C++17)
|
información sobre el espacio libre y disponible en el sistema de archivos
(clase) |