std::messages<CharT>::open, std::messages<CharT>::do_open

Определено в заголовочном файле `<locale>`
public: catalog open( const std::string& name, const std::locale& loc ) const;	(1)
protected: virtual catalog do_open( const std::string& name, const std::locale& loc ) const;	(2)

1) Открытая функция-член, вызывает защищённую виртуальную функцию-член do_open наиболее производного класса.

2) Получает значение типа catalog (унаследованного от std::messages_base), которое можно передать в get() для получения сообщений из каталога сообщений, указанного в name. Это значение можно использовать до тех пор, пока оно не будет передано в close().

Параметры

name	-	имя открываемого каталога сообщений
loc	-	объект локали, предоставляющий дополнительные фасеты, которые могут потребоваться для чтения сообщений из каталога, например `std::codecvt` для преобразований между широкими и многобайтовыми символами

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

Неотрицательное значение типа catalog, которое можно использовать с get() и close(). Возвращает отрицательное значение, если каталог не удалось открыть.

Примечания

В системах POSIX этот вызов функции обычно преобразуется в вызов catopen(). В GNU libstdc++ он вызывает textdomain.

Фактическое расположение каталога определяется реализацией: например, для каталога "sed" (каталогов сообщений, установленных с помощью утилиты Unix 'sed') в немецкой локали файл, открываемый этим вызовом функции, может находиться по адресу /usr/lib/nls/msg/de_DE/sed.cat, /usr/lib/locale/de_DE/LC_MESSAGES/sed.cat или /usr/share/locale/de/LC_MESSAGES/sed.mo.

Пример

В следующем примере демонстрируется получение сообщений: в типичной системе GNU/Linux данные считываются из /usr/share/locale/de/LC_MESSAGES/sed.mo.

#include <iostream>
#include <locale>

int main()
{
    std::locale loc("de_DE.utf8");
    std::cout.imbue(loc);
    auto& facet = std::use_facet<std::messages<char>>(loc);
    auto cat = facet.open("sed", loc);
    if (cat < 0)
        std::cout << "Could not open german \"sed\" message catalog\n";
    else
        std::cout << "\"No match\" in German: "
                  << facet.get(cat, 0, 0, "No match") << '\n'
                  << "\"Memory exhausted\" in German: "
                  << facet.get(cat, 0, 0, "Memory exhausted") << '\n';
    facet.close(cat);
}

Возможный вывод:

"No match" in German: Keine Übereinstimmung
"Memory exhausted" in German: Speicher erschöpft

См. также

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/locale/messages/open