gettext によるメッセージ処理

gettext は標準 C 言語の機能ではありませんが、オープンソースを中心に広く使われているメッセージ外部化の枠組みです。catopne() や catgets() を使用する標準 C 言語のメッセージ外部化と考え方は同じですが、メッセージの参照にセット番号やメッセージ番号ではなく英語版文字列自身 (のハッシュ値) を使用する点が異なります。

gettext 関連の関数には次のものがあります。

------------------------------------------------------------------------
間数名			概要
------------------------------------------------------------------------
gettext			メッセージを取得する
dgettext		メッセージを取得する
dcgettext		メッセージを取得する
ngettext		メッセージを取得する
dngettext		メッセージを取得する
dcngettext		メッセージを取得する
bindtextdomain		ドメインとディレクトリを結び付ける
textdomain		ドメインを選択する
bind_textdomain_codeset	出力メッセージのエンコーディングを指定する
_			メッセージを取得する (マクロ)
N_			メッセージの取り出しを関連ツールに指示する (マクロ)
gettext_noop		メッセージの取り出しを関連ツールに指示する (マクロ)
------------------------------------------------------------------------

最後の３つはマクロです。定義は通常以下のとおりです。

#define _(String)   gettext(String)
#define N_(String)  gettext_noop(String)
#define gettext_noop(String) (String)

gettext 関連ツールはこの関数呼び出しをキーとしてソースファイルからメッセージを取り出します。最初のマクロはさらに、プログラム実行時に gettext() を呼び出します。

*** gettextの手順 ***

基本的な発想はメッセージカタログを使った手法と同じです。
メッセージカタログについてはこちらを参照してください。
ここではメッセージカタログと違う部分について説明します。

メッセージファイル

プログラムからかき集めたメッセージは.potファイルに記述します。
以下はWorld Wide Naviで作成された例です。

wwnavi_get.pot

# $NLS-WWNAVI 2008-05-24T17:48:21+0900
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2008-05-24T17:48:21+0900\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME \n"
"Language-Team: LANGUAGE \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n" <-- *エンコーディング名
"Content-Transfer-Encoding: 8bit\n"

# Test.c
msgid "Failed to create fontset\n" <-- *メッセージID
msgstr "Failed to create fontset\n" <-- *メッセージ

msgid "Hello, how are you? This is sample for gettext. (Push .)"
msgstr "Hello, how are you? This is sample for gettext. (Push .)"

メッセージファイルをコンパイルする。

msgfmtコマンドを使って.potファイルを読み込み可能なファイル(.mo)にコンパイルします。
```
msgfmt -o wwnavi_get.mo wwnavi_get.pot
```

メッセージ読み込み処理を記述する。

ソース内に以下のようなコードを記述します。

setlocale (LC_ALL, ""); <-- *main関数内に記述。
bindtextdomain("wwnavi_get", "."); <-- *main関数内に記述。
textdomain("wwnavi_get"); <-- *main関数内に記述。
...
printf(_(N_("Failed to create fontset\n"))); <-- *メッセージ読み込み

.moファイルを配置する。

.moファイルの場所はメッセージカタログ同様環境に依存しますが、

例えば以下のような設定でプログラム(Test)を実行した場合、
```
export LANG=en_US.UTF-8
./Test
export LANG=ja_JP.UTF-8
./Test
```
.moファイルは以下に配置可能です。
```
./en/LC_MESSAGES/wwnavi_get.mo <-- *英語メッセージファイル
./ja/LC_MESSAGES/wwnavi_get.mo <-- *日本語メッセージファイル   
```

上記はWorld Wide Navi付属のサンプルコード(linux_gettext)にgettextの外部化を実行することで確認できます。

国際化プログラミングトップへ