std::filesystem:: u8path

Создает путь p из UTF-8 кодированной последовательности char s или char8_t s (since 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 узких символьных кодировок и для не-UTF-16 wchar_t ), сначала преобразует UTF-8 последовательность символов во временную строку tmp типа std:: u32string с кодировкой UTF-32, и затем новый путь конструируется как если бы через 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

Смотрите также