Macro

NSLocalizedString

Returns a localized version of a string from the default table, which Xcode autogenerates when exporting localizations. 省略時の対応表からある文字列のローカライズ版を返します、それはXcodeがローカライゼーションのエクスポート時に自動生成します。

Declaration 宣言

#define NSLocalizedString(key, comment)

Parameters パラメータ

key

The key for a string in the default table. 省略時のテーブルの中のある文字列に対するキー。

comment

The comment to place above the key-value pair in the strings file. This parameter provides the translator with some context about the localized string’s presentation to the user. stringsファイルにおいてキー値ペアの上方に置くことになるコメント。このパラメータは、ローカライズされた文字列のユーザへの提示についての何らかの文脈をトランスレータに提供します。

Return Value 戻り値

The result of sending localizedStringForKey:value:table: to the main bundle, passing the specified key. localizedStringForKey:value:table:をメインバンドルへと、この指定されたkeyを渡して、送信する結果。

Discussion 議論

Use this macro to automatically generate the default Localizable.strings file from your code when exporting localizations from Xcode or the genstrings utility. You can specify Unicode characters in key using \\Uxxxx—see the -u option for the genstrings utility. このマクロを使って、省略時のLocalizable.stringsファイルを、ローカライゼーションそれらをXcodeまたはgenstringsユーディリティからエクスポートする時にあなたのコードから自動的に生成してください。あなたは、Unicode文字をkeyにおいて\\Uxxxxを使って指定できます — genstringsユーティリティの-uオプションを見てください。

The initial value for key in the strings file is key. To avoid collisions between words or phrases with multiple meanings, use a unique key for each use of the same phrase. Use the NSLocalizedStringWithDefaultValue macro to specify another value for key. stringsファイルの中のkeyに対する初期値は、keyです。複数の意味をもつ単語や語句の間の衝突を防ぐために、同じ語句のそれぞれの利用法ごとに固有のkeyを使ってください。NSLocalizedStringWithDefaultValueマクロを使って、別の値をkeyに対して指定してください。

For information about inserting plural nouns and units into localized strings, see Localizing Strings That Contain Plurals. 複数の名詞と単位をローカライズされたstringsへと挿入することについての情報として、Localizing Strings That Contain Pluralsを見てください。

As of OS X 10.11 and iOS 9, NSBundle is thread-safe. As such, you can safely call NSLocalizedString from any execution context. OS X 10.11とiOS 9時点で、NSBundleはスレッド安全です。そういうことで、あなたはNSLocalizedStringをどんな実行文脈からでも安全に呼び出し可能です。


NSLocalizedString(
    @"Did you know that venus flytraps have flowers"
        @" atop very long stems?\nThe long stem keeps"
        @" insects a safe distance away from their"
        @" digestive leaves below.",
    @"An interesting fact about venus flytraps shown"
        @" on the loading screen.");

See Also 参照

Localization ローカライゼーション

Related Documentation 関連文書