Constructs a pathp from a UTF-8 encoded sequence ofchars, supplied either as anstd::string, or as a null-terminated multibyte string, or as a [first,last) iterator pair.

• Ifpath::value_type ischar and native encoding is UTF-8, constructs a path directly as if bypath(source) orpath(first, last). Note: this is the typical situation of a POSIX system that uses Unicode, such as Linux.
• Otherwise, ifpath::value_type iswchar_t and native encoding is UTF-16 (this is the situation on Windows), or ifpath::value_type ischar16_t (native encoding guaranteed UTF-16) orchar32_t (native encoding guaranteed UTF-32), then first converts the UTF-8 character sequence to a temporary stringtmp of typepath::string_type and then the new path is constructed as if bypath(tmp).
• Otherwise (for non-UTF-8 narrow character encodings and for non-UTF-16 wchar_t), first converts the UTF-8 character sequence to a temporary UTF-32-encoded stringtmp of typestd::u32string, and then the new path is constructed as if bypath(tmp) (this path is taken on a POSIX system with a non-Unicode multibyte or single-byte encoded filesystem).

[edit]Parameters

[edit]Return value

The path constructed from the input string after conversion from UTF-8 to the filesystem's native character encoding.

[edit]Exceptions

May throwfilesystem_error on underlying OS API errors orstd::bad_alloc if memory allocation fails.

[edit]Notes

On systems where native path format differs from the generic path format (neither Windows nor POSIX systems are examples of such OSes), if the argument to this function is using generic format, it will be converted to native.

[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");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);}

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

[edit]See also