| 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
#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);
}File contentsSee also
| returns the path in native pathname format converted to a string (public member function) | |
| returns the path in generic pathname format converted to a string (public member function) |
Content from this page on cppreference.com, licensed under CC-BY-SA 3.0 and GFDL. Modified: restyled, site navigation removed, code windows added. Offline snapshot of 9 February 2025.