localize (マクロ)
パッケージ: CURL.LANGUAGE.COMPILER

シグネチャ

                {localize
                    original:String,
                    key:String = original,
                    comment:String = ""
                }:String

文字列のロケール固有の変換を指定します。

original: 翻訳が見つからないときに返されるオリジナルテキスト。このパラメータは、String リテラル、または & 演算子で連結された一連の String リテラルでなければなりません。
key: 翻訳辞書で翻訳を検索するのに使われるキー。既定では、キーは元のテキストになります。翻訳辞書内に文字列の異なる翻訳を要求する複数のインスタンスがある場合は、一意性を確保する上でキーの指定が役に立ちます。このパラメータを指定する場合、original 引数のようなコンパイル時の定数でなければなりません。特別なケースとして、値に対して {message some words} の呼び出しを使うこともできます。
comment: この文字列をローカライズする翻訳者へのヒントになるような文字列。それ以外には使用されません。これは、key 引数のようにコンパイル時の定数でなければなりません。

説明

作業中のロケール (get-working-locale を参照) で現在のパッケージに関連付けられている TranslationDictionary を使って key を検索し、結果の String を返します。辞書に合致する文字列がない場合は、代わりに original が返されます。