if value_type is wchar_t and the
native wide encoding is UTF-16, or
if value_type is char16_t or char32_t,
convert source or [first, last)
to a temporary, tmp, of type string_type and
return path(tmp);
otherwise,
A string is to be read from a database that is encoded in UTF-8, and used
to create a directory using the native encoding for filenames:
namespace fs = std::filesystem;
std::string utf8_string = read_utf8_data();
fs::create_directory(fs::u8path(utf8_string));
For POSIX-based operating systems with the native narrow encoding set
to UTF-8, no encoding or type conversion occurs.
For POSIX-based operating systems with the native narrow encoding not
set to UTF-8, a conversion to UTF-32 occurs, followed by a conversion to the
current native narrow encoding.
Some Unicode characters may have no native character
set representation.
For Windows-based operating systems a conversion from UTF-8 to
UTF-16 occurs.
The example above is representative of
a historical use of filesystem::u8path.
To indicate a UTF-8 encoding,
passing a std::u8string to path's constructor is preferred
as it is consistent with path's handling of other encodings.