Namespaces
Variants

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

From cppreference.net
C++
Text processing library
Localization library
std::messages
Определено в заголовочном файле <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

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