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

< cpp‎ | experimental‎ | fs‎ | path
Technical specifications
Filesystem library (filesystem TS)
Library fundamentals (library fundamentals TS)
Library fundamentals 2 (library fundamentals TS v2)
Library fundamentals 3 (library fundamentals TS v3)
Extensions for parallelism (parallelism TS)
Extensions for parallelism 2 (parallelism TS v2)
Extensions for concurrency (concurrency TS)
Extensions for concurrency 2 (concurrency TS v2)
Concepts (concepts TS)
Ranges (ranges TS)
Reflection (reflection TS)
Mathematical special functions (special functions TR)
const value_type* c_str() const;
(1) (filesystem TS)
const string_type& native() const;
(2) (filesystem TS)
operator string_type() const;
(3) (filesystem TS)

Accesses the native path name as a character string.

1) Equivalent to native().c_str().
2) Returns the native string representation of the pathname by reference.
3) Returns the native string representation of the pathname by value.


[edit] Parameters


[edit] 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.

[edit] Exceptions

noexcept specification:  

[edit] Notes

The conversion function (3) is provided so that standard file-opening APIs that accept std::basic_string file names, such as the std::ifstream constructor, can use pathnames with no changes to code:

fs::path p = "/tmp/text.txt";
std::ifstream f(p);

[edit] Example

#include <clocale>
#include <cstdio>
#include <experimental/filesystem>
#include <fstream>
#include <iostream>
namespace fs = std::experimental::filesystem;
int main()
    std::setlocale(LC_ALL, "en_US.utf8");
    fs::path p = fs::u8path(u8"要らない.txt");
    // native string representation can be used with OS APIs
    std::ofstream(p) << "File contents"; // this uses operator string()
    if (std::FILE* f = std::fopen(p.c_str(), "r"))
        int ch;
        while ((ch=fgetc(f))!= EOF) putchar(ch);
    // multibyte and wide representation can be used for output
    std::cout << "\nFile name in narrow multibyte encoding: "
              << p.string() << '\n';
    std::wcerr << "File name in wide encoding: "
               << p.wstring() << '\n';

Possible output:

File contents
File name in narrow multibyte encoding: 要らない.txt
File name in wide encoding: 要らない.txt

[edit] See also

returns the path in native pathname format converted to a string
(public member function) [edit]
returns the path in generic pathname format converted to a string
(public member function) [edit]