std::filesystem::u8path

template< class Source >
std::filesystem::path u8path( const Source& source );

template< class InputIt >
std::filesystem::path u8path( InputIt first, InputIt last );

Создаёт путь p из последовательности символов char в кодировке UTF-8 или char8_t(начиная с C++20), заданной в виде std::string, std::string_view, строки многобайтовых символов с нулевым терминатором или пары итераторов [first, last).

• Если path::value_type — char, а собственная кодировка — UTF-8, путь создаётся напрямую, как если бы использовался path(source) или path(first, last). Примечание: это типичный случай для системы POSIX, использующей Unicode, например Linux.
• В противном случае, если path::value_type — wchar_t, а собственная кодировка — UTF-16 (так обстоит дело в Windows), либо если path::value_type — char16_t (собственная кодировка гарантированно UTF-16) или char32_t (собственная кодировка гарантированно UTF-32), сначала последовательность символов UTF-8 преобразуется во временную строку tmp типа path::string_type, а затем новый путь создаётся так, как если бы использовался path(tmp).
• В противном случае (для узких кодировок символов, отличных от UTF-8, и для wchar_t, отличных от UTF-16) последовательность символов UTF-8 сначала преобразуется во временную строку в кодировке UTF-32 tmp типа std::u32string, а затем новый путь создаётся так, как если бы использовался path(tmp) (этот вариант применяется в системе POSIX с файловой системой, использующей многобайтовую или однобайтовую кодировку, не основанную на Unicode).

Параметры

Возвращаемое значение

Путь, созданный из входной строки после преобразования из UTF-8 в собственную кодировку символов файловой системы.

Исключения

Может выбрасывать std::bad_alloc при сбое выделения памяти.

Примечания

В системах, где собственный формат пути отличается от универсального формата пути (например, в ОС, отличных от Windows и POSIX), если аргумент этой функции задан в универсальном формате, он будет преобразован в собственный формат.

Пример

#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 contents

См. также