Чтение онлайн

на главную - закладки

Жанры

Linux программирование в примерах
Шрифт:

#include <libintl.h> /* GLIBC */

char* textdomain(const char *domainname)

Каждый компонент должен вызывать эту функцию со строкой, указывающей на текстовый домен, в составе первоначальной инициализации в

main
. Возвращаемое значение является текущим текстовым доменом. Если аргумент
domainname
равен
NULL
, возвращается текущий домен; в противном случае, он устанавливается в указанное значение, а последнее возвращается. Возвращаемое значение
NULL
указывает на какую-нибудь разновидность ошибки.

Если текстовый домен не установлен с помощью

textdomain
, по умолчанию используется «
messages
».

13.3.2. Перевод сообщений:

gettext

Следующим после установки текстового домена шагом является использование функции

gettext
(или ее разновидности) для каждой строки, которая должна быть переведена. Несколько функций предоставляют службы перевода:

#include <libintl.h> /* GLIBC */

char *gettext(const char *msgid);

char *dgettext(const char *domainname, const char *msgid);

char *dcgettext(const char *domainname, const char *msgid, int category);

Аргументы, используемые в этих функциях, следующие:

const char *msgid

Переводимая строка. Она действует в качестве ключа к базе данных переводов.

const char *domainname

Текстовый домен, из которого нужно получить перевод. Таким образом, хотя

main
вызвала
textdomain
для установки собственного домена приложения, сообщения могут быть получены из других текстовых доменов. (Это наиболее применимо к сообщениям, которые могли бы быть, например, в текстовом домене библиотеки от третьей стороны.)

int category

Одна из описанных ранее категорий доменов (

LC_TIME
и т.п.). Доменом по умолчанию является то, что было раньше установлено с помощью
textdomain
(«
messages
», если
textdomain
никогда не вызывалась). Категорией по умолчанию является
LC_MESSAGES
. Предположим,
main
делает следующий вызов:

textdomain("killerapp");

Тогда '

gettext("my message")
' эквивалентно '
dgettext("killerapp", "my message")
'. Обе функции, в свою очередь, эквивалентны '
dcgettext("killerapp", "my message", LC_MESSAGES)
'.

В 99,9% времени бывает нужно использовать

gettext
. Однако, другие функции обеспечивают гибкость при работе с другими текстовыми доменами или категориями локалей. Скорее всего, эта гибкость потребуется при программировании библиотек, поскольку автономная библиотека почти наверняка будет использовать свой собственный текстовый домен.

Все функции возвращают строки. Строка является либо переводом данного

msgid
, либо, если перевода не существует, первоначальной строкой. Таким образом, всегда имеется какой-нибудь вывод, даже если это первоначальное
сообщение (предположительно на английском). Например:

/* Каноническая первая программа, локализованная версия. */

#include <stdio.h>

#include <locale.h>

#include <libintl.h>

int main(void) {

 setlocale(LC_ALL, "");

 printf("%s\n", gettext("hello, world"));

 return 0;

}

Хотя сообщение является простой строкой, мы не используем ее непосредственно в форматирующей строке

printf
, поскольку в общем перевод может содержать символы
%
.

Вскоре, в разделе 13.3.4 «Упрощение использования

gettext
», мы увидим, как облегчить использование
gettext
в крупномасштабных, реальных программах.

13.3.3. Работа с множественными числами:

ngettext

Перевод во множественном числе доставляет дополнительные трудности. Простой код мог бы выглядеть примерно так:

printf("%d word%s misspelled\n", nwords, nwords > 1 ? "s" : "");

/* или */

printf("%d %s misspelled\n", nwords, nwords == 1 ? "word" : "words").

Это подходит для английского языка, но перевод становится трудным. Во-первых, во многих языках множественное число не образуется с такой же легкостью, как в английском (добавлением суффикса

s
для большинства слов). Во-вторых, во многих языках, особенно в Восточной Европе, имеются несколько форм множественного числа, каждая из которых указывает на то, сколько объектов обозначает форма. Соответственно даже код наподобие следующего не будет достаточным:

if (nwords == l)

 printf("one word misspelled\n");

else

 printf("%d words misspelled\n", nwords);

Решением является параллельный набор процедур специально для форматирования множественных значений:

#include <libintl.h> /* GLIBC */

char *ngettext(const char *msgid, const char *msgid_plural,

 unsigned long int n);

char *dngettext(const char *domainname, const char *msgid,

 const char *msgid_plural, unsigned long int n);

char *dcngettext(const char *domainname, const char *nmgid,

 const char *msgid_plural, unsigned long int n,

 int category)

Помимо первоначального аргумента

msgid
, эти функции принимают дополнительные аргументы:

const char *msgid_plural

Строка по умолчанию для использования в качестве множественного числа. Вскоре будут примеры.

Поделиться:
Популярные книги

Краткая история этики

Гусейнов Абдусалам
Научно-образовательная:
философия
5.83
рейтинг книги
Краткая история этики

Развилки новейшей истории России

Чубайс Анатолий
Детективы:
триллеры
6.25
рейтинг книги
Развилки новейшей истории России

Метатель

Тарасов Ник
1. Метатель
Фантастика:
боевая фантастика
попаданцы
рпг
фэнтези
фантастика: прочее
постапокалипсис
4.80
рейтинг книги
Метатель

История украинского народа. Автобиография

Грушевський Михайло Сергійович
Документальная литература:
биографии и мемуары
5.00
рейтинг книги
История украинского народа. Автобиография

Печать пожирателя 2

Соломенный Илья
2. Пожиратель
Фантастика:
городское фэнтези
попаданцы
аниме
сказочная фантастика
5.00
рейтинг книги
Печать пожирателя 2

Газлайтер. Том 28

Володин Григорий Григорьевич
28. История Телепата
Фантастика:
боевая фантастика
аниме
попаданцы
5.60
рейтинг книги
Газлайтер. Том 28

Паладин из прошлого тысячелетия

Еслер Андрей
1. Соприкосновение миров
Фантастика:
боевая фантастика
попаданцы
6.67
рейтинг книги
Паладин из прошлого тысячелетия

Этот мир не выдержит меня. Том 4

Майнер Максим
Первый простолюдин в Академии
Фантастика:
фэнтези
попаданцы
аниме
5.00
рейтинг книги
Этот мир не выдержит меня. Том 4

TCP/IP Архитектура, протоколы, реализация (включая IP версии 6 и IP Security)

Фейт Сидни М.
Компьютеры и Интернет:
ос и сети
5.00
рейтинг книги
TCP/IP Архитектура, протоколы, реализация (включая IP версии 6 и IP Security)

Мир InterBase. Архитектура, администрирование и разработка приложений баз данных в InterBase/FireBird/Yaffil

Востриков С М
Компьютеры и Интернет:
базы данных
программирование
5.00
рейтинг книги
Мир InterBase. Архитектура, администрирование и разработка приложений баз данных в InterBase/FireBird/Yaffil

Письма

Уайльд Оскар
Символы времени
Документальная литература:
биографии и мемуары
5.00
рейтинг книги
Письма

Террор и демократия в эпоху Сталина. Социальная динамика репрессий

Голдман Венди З.
История сталинизма
Научно-образовательная:
история
5.00
рейтинг книги
Террор и демократия в эпоху Сталина. Социальная динамика репрессий

Законы Рода. Том 9

Мельник Андрей
9. Граф Берестьев
Фантастика:
городское фэнтези
попаданцы
аниме
дорама
фэнтези
фантастика: прочее
5.00
рейтинг книги
Законы Рода. Том 9

Личник

Валериев Игорь
3. Ермак
Фантастика:
альтернативная история
6.33
рейтинг книги
Личник