# std::experimental::filesystem::space_info

> C++ Atlas: `cppatlas.com/w/cpp/experimental/fs/space_info` | Source: https://en.cppreference.com/w/cpp/experimental/fs/space_info | Domain: Technical specifications

Represents the filesystem information as determined by space.

## Official Specification Summary (cppreference)

```cpp
// Defined in header <experimental/filesystem>

struct space_info {
    uintmax_t capacity;
    uintmax_t free;
    uintmax_t available;
}; // (filesystem TS)
```

Represents the filesystem information as determined by space.

The members have the following meaning:

- `capacity` -- total size of the filesystem, in bytes
- `free` -- free space on the filesystem, in bytes
- `available` -- free space available to a non-privileged process (may be equal or less than `free`)

### Example

```cpp
#include <experimental/filesystem>
#include <iostream>
namespace fs = std::experimental::filesystem;

int main()
{
    fs::space_info devi = fs::space("/dev/null");
    fs::space_info tmpi = fs::space("/tmp");

    std::cout << "         Capacity         Free    Available\n"
              << "/dev:   " << devi.capacity << "   "
              << devi.free << "   " << devi.available << '\n'
              << "/tmp: " << tmpi.capacity << ' '
              << tmpi.free << ' ' << tmpi.available << '\n';
}
```

Possible output:

```text
          Capacity         Free    Available
/dev:   4175114240   4175110144   4175110144
/tmp: 420651237376 411962273792 390570749952
```

### See also

- [`space`](https://en.cppreference.com/w/cpp/experimental/fs/space): determines available free space on the file system (function)

---
Attribution: content from https://en.cppreference.com/w/cpp/experimental/fs/space_info (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.