Spec-Zone.ru › C++

std::messages<CharT>::get, std::messages<CharT>::do_get

Определён в заголовочном файле <locale>
public:
string_type get( catalog cat, int set, int msgid, const string_type& dfault ) const;
(1)
protected:
virtual string_type do_get( catalog cat, int set, int msgid, const string_type& dfault ) const;
(2)
1) Открытая функция-член вызывает защищённую виртуальную функцию-член do_get наиболее производного класса.
2) Получает сообщение из открытого каталога сообщений cat, используя значения set, msgid и dfault способом, определяемым реализацией. Если ожидаемое сообщение не найдено в каталоге, возвращает копию dfault.

Параметры

cat - идентификатор каталога сообщений, полученный с помощью open() и ещё не переданный в close()
set - аргумент, определяемый реализацией; набор сообщений в POSIX
msgid - аргумент, определяемый реализацией; идентификатор сообщения в POSIX
dfault - строка для поиска в каталоге (если в каталоге используется поиск по строке), а также строка, возвращаемая в случае ошибки

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

Сообщение из каталога или копия dfault, если сообщение не найдено.

Примечания

В системах POSIX этот вызов функции обычно преобразуется в вызов catgets(), а параметры set, msgid и dfault передаются в catgets() без изменений. В GNU libstdc++ эта функция игнорирует set и msgid и просто вызывает GNU gettext(dfault) в требуемой локали.

Пример

В следующем примере показано получение сообщений: в типичной системе 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/get

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API