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

Определено в заголовке `<locale>`
public: catalog open( const std::basic_string<char>& name, const std::locale& loc ) const;	(1)
protected: virtual catalog do_open( const std::basic_string<char>& 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/w/cpp/locale/messages/open