| Member types | ||||||
| Member constants | ||||||
| Member functions | ||||||
| Path decomposition | ||||||
| Non-member functions | ||||||
| ||||||
| Helper classes | ||||||
const value_type* c_str()constnoexcept; | (1) | (since C++17) |
const string_type& native()constnoexcept; | (2) | (since C++17) |
operator string_type()const; | (3) | (since C++17) |
Accesses the native path name as a character string.
Contents |
(none)
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.
The conversion function(3) is provided so that APIs that acceptstd::basic_string file names can use pathnames with no changes to code.
#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);#elsestd::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_VERif(std::FILE* f= _wfopen(p.c_str(), L"r"))#elseif(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:
File contents
| 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] |