# std::filesystem::path::root_name

> C++ Atlas: `cppatlas.com/w/cpp/filesystem/path/root_name` | Source: https://en.cppreference.com/w/cpp/filesystem/path/root_name | Domain: Filesystem | Standards: C++17

Returns the root name of the generic-format path. If the path (in generic format) does not include root name, returns path().

## Official Specification Summary (cppreference)

```cpp
path root_name() const; // (since C++17)
```

Returns the root name of the generic-format path. If the path (in generic format) does not include root name, returns `path()`.

### Parameters

(none)

### Return value

The root name of the path.

### Exceptions

May throw implementation-defined exceptions.

### Example

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

int main()
{
    std::cout << "Current root name is: " << fs::current_path().root_name() << '\n';
}
```

Possible output:

```text
Current root name is: "C:"
```

### See also

- [`root_directory`](https://en.cppreference.com/w/cpp/filesystem/path/root_directory): returns the root directory of the path, if present (public member function)
- [`root_path`](https://en.cppreference.com/w/cpp/filesystem/path/root_path): returns the root path of the path, if present (public member function)

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