1.6 KiB
[fs.op.space]
31 Input/output library [input.output]
31.12 File systems [filesystems]
31.12.13 Filesystem operation functions [fs.op.funcs]
31.12.13.35 Space [fs.op.space]
space_info filesystem::space(const path& p); space_info filesystem::space(const path& p, error_code& ec) noexcept;
Returns: An object of type space_info.
The value of the space_info object is determined as if by using POSIX statvfs to obtain a POSIX struct statvfs, and then multiplying its f_blocks, f_bfree, and f_bavail members by its f_frsize member, and assigning the results to the capacity, free, and available members respectively.
Any members for which the value cannot be determined shall be set to static_cast<uintmax_t>(-1).
For the signature with argument ec, all members are set to static_cast<uintmax_t>(-1) if an error occurs.
Throws: As specified in [fs.err.report].
Remarks: The value of member space_info::available is operating system dependent.
[Note 1:
available might be less than free.
â end note]