| Technical Specification | ||||
| 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) | ||||
| Experimental Non-TS | ||||
| Pattern Matching | ||||
| Linear Algebra | ||||
| std::execution | ||||
| Contracts | ||||
| 2D Graphics |
| Classes | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Functions | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| File types | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Member functions | ||||
| Path decomposition | ||||
| Non-member functions | ||||
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.
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 standard file-opening APIs that acceptstd::basic_string file names, such as thestd::ifstream constructor, can use pathnames with no changes to code:
fs::path p="/tmp/text.txt";std::ifstream f(p);
#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");std::locale::global(std::locale("en_US.utf8")); fs::path p= fs::u8path(u8"要らない.txt"); // native string representation can be used with OS APIsstd::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);std::fclose(f);} // multibyte and wide representation can be used for outputstd::cout.imbue(std::locale());std::cout<<"\nFile name in narrow multibyte encoding: "<< p.string()<<'\n'; std::wcerr.imbue(std::locale());std::wcerr<<"File name in wide encoding: "<< p.wstring()<<'\n'; fs::remove(p);}
Possible output:
File contentsFile name in narrow multibyte encoding: 要らない.txtFile name in wide encoding: 要らない.txt
| 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] |
