Macro

NSLocalizedStringFromTable

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

Declaration 宣言

#define NSLocalizedStringFromTable(key, tbl, comment)

Parameters パラメータ

key

The key for a string in the specified table. 指定された表の中のある文字列に対するキー。

tableName

The name of the table containing the key-value pairs. Also, the suffix for the strings file (a file with the .strings extension) to store the localized string. The default table in Localizable.strings is used when tableName is nil or an empty string. キー値ペアを含んでいる表の名前。または、ローカライズされた文字列を格納するためのstringsファイル(.strings拡張子をもつファイル)に対する接尾辞。Localizable.strings の中の省略時の表は、tableNamenilまたは空文字列の時に使われます。

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 invoking localizedStringForKey:value:table: on the main bundle, passing the specified key and tableName. localizedStringForKey:value:table:をメインバンドル上で、この指定されたkeytableNameを渡して発動する結果。

Discussion 議論

Use this macro to automatically generate a strings file named [tableName].strings 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. このマクロを使って、[tableName].stringsと名前をつけられる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 NSLocalizedStringFromTable from any execution context. OS X 10.11とiOS 9時点で、NSBundleはスレッド安全です。そういうことで、あなたはNSLocalizedStringFromTableをどんな実行文脈からでも安全に呼び出し可能です。


NSLocalizedStringFromTable(
    @"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.",
    @"Localized",
    @"An interesting fact about venus flytraps shown"
        @" on the loading screen.");

See Also 参照

Localization ローカライゼーション

Related Documentation 関連文書