std::experimental::filesystem:: u8path

Создает путь p из UTF-8 кодированной последовательности char s, предоставленной либо в виде std::string , либо в виде нуль-терминированной многобайтовой строки, либо в виде пары итераторов [ 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 последовательность символов во временную строку с кодировкой UTF-32 tmp типа std:: u32string , и затем новый путь конструируется как если бы через path ( tmp ) (этот путь выбирается в POSIX-системах с не-Unicode многобайтовой или однобайтовой кодировкой файловой системы).

Параметры

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

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

Исключения

Может выбрасывать filesystem_error при ошибках в нижележащих API операционной системы или std:: bad_alloc при неудачном выделении памяти.

Примечания

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

Пример

#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 APIs
    std::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 output
    std::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 contents
File name in narrow multibyte encoding: 要らない.txt
File name in wide encoding: 要らない.txt

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