# std::filesystem::path::c_str, std::filesystem::path::native, std::filesystem::path::operator string_type()

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

Accesses the native path name as a character string.

## Official Specification Summary (cppreference)

```cpp
const value_type* c_str() const noexcept; // (1) (since C++17)
const string_type& native() const noexcept; // (2) (since C++17)
operator string_type() const; // (3) (since C++17)
```

Accesses the native path name as a character string.

1) Equivalent to `native().c_str()`.

2) Returns the native-format representation of the pathname by reference.

3) Returns the native-format representation of the pathname by value.

### Parameters

(none)

### Return value

The native string representation of the pathname, using native syntax, native character type, and native character encoding. This string is suitable for use with OS APIs.

### Notes

The conversion function (3) is provided so that APIs that accept `std::basic_string` file names can use pathnames with no changes to code.

### Example

```cpp
#include <cstdio>
#ifdef _MSC_VER
#include <fcntl.h>
#include <io.h>
#else
#include <clocale>
#include <locale>
#endif
#include <filesystem>
#include <fstream>

int main()
{
#ifdef _MSC_VER
    _setmode(_fileno(stderr), _O_WTEXT);
#else
    std::setlocale(LC_ALL, "");
    std::locale::global(std::locale(""));
#endif

    std::filesystem::path p(u8"要らない.txt");
    std::ofstream(p) << "File contents"; // Prior to LWG2676 uses operator string_type()
                                         // on MSVC, where string_type is wstring, only
                                         // works due to non-standard extension.
                                         // Post-LWG2676 uses new fstream constructors

    // Native string representation can be used with OS-specific APIs
#ifdef _MSC_VER
    if (std::FILE* f = _wfopen(p.c_str(), L"r"))
#else
    if (std::FILE* f = std::fopen(p.c_str(), "r"))
#endif
    {
        for (int ch; (ch = fgetc(f)) != EOF; std::putchar(ch))
        {}
        std::fclose(f);
    }

    std::filesystem::remove(p);
}
```

Possible output:

```text
File contents
```

### See also

- [`string`](https://en.cppreference.com/w/cpp/filesystem/path/string), [`wstring`](https://en.cppreference.com/w/cpp/filesystem/path/string), [`u8string`](https://en.cppreference.com/w/cpp/filesystem/path/string), [`u16string`](https://en.cppreference.com/w/cpp/filesystem/path/string), [`u32string`](https://en.cppreference.com/w/cpp/filesystem/path/string): returns the path in native pathname format converted to a string (public member function)
- [`generic_string`](https://en.cppreference.com/w/cpp/filesystem/path/generic_string), [`generic_wstring`](https://en.cppreference.com/w/cpp/filesystem/path/generic_string), [`generic_u8string`](https://en.cppreference.com/w/cpp/filesystem/path/generic_string), [`generic_u16string`](https://en.cppreference.com/w/cpp/filesystem/path/generic_string), [`generic_u32string`](https://en.cppreference.com/w/cpp/filesystem/path/generic_string): returns the path in generic pathname format converted to a string (public member function)

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