インスタンスメソッド

localizedString(forKey:value:table:)

指定されたキーで指名され、指定された表に存在する文字列のローカライズされたバージョンを返します。

iOS 2.0+ iPadOS 2.0+ Mac Catalyst 13.0+ macOS 10.0+ tvOS 9.0

visionOS 1.0+ watchOS 2.0+

func localizedString(

forKey key: String,

value: String?,

table tableName: String?

) -> String

パラメータ

key

tableName で識別される表内の文字列のキー。

value

key が nil の場合、または key のローカライズされた文字列が表内に見つからない場合に返される値。

tableName

検索すべき受信者の文字列の表。tableName が nil または空の文字列の場合、メソッドは Localizable.strings 内の表を使用しようとします。

戻り値

表 tableName 内の key で指名された文字列のローカライズされたバージョン。kry が nil であるか、表内に見つからない場合、このメソッドは以下を返します。

key が nil で value が nil の場合は、空の文字列を返します。

key が nil で value が nil 以外の場合は、値を返します。

key が見つからず、value が nil または空の文字列の場合は、key を返します。

key が見つからず、value が nil 以外で空でない場合は、value を返します。

議論

文字列のローカライズと .strings ファイルの仕様の詳細については、文字列リソース ("String Resources”) を参照してください。

ユーザのデフォルトの NSShowNonLocalizedStrings を使用すると、localizedString(forKey:value:table:) (リンク切れ) の動作を変更して、メソッドがローカライズされた文字列を見つけられない場合にメッセージをログに記録できます。このデフォルトを true に設定すると (グローバルドメインまたはアプリケーションのドメインで)、メソッドが表内でローカライズされた文字列を見つけられない場合、コンソールにメッセージがログに記録され、key が大文字になってから返されます。

以下の例では、ボタンがクリックされたときにキーの静的配列を循環させ、Buttons.strings という名前の文字列の表から各キーの値を取得し、返された値でボタンのタイトルを設定します。

- (void)changeTitle:(id)sender
{
static int keyIndex = 0;
NSBundle *thisBundle = [NSBundle bundleForClass:[self class]];
NSString *locString = [thisBundle
localizedStringForKey:assortedKeys[keyIndex++]
value:@"No translation" table:@"Buttons"];
[sender setTitle:locString];
if (keyIndex == MAXSTRINGS) keyIndex=0;
}

XCode 16.0 日本語化計画

インスタンスメソッド

localizedString(forKey:value:table:)

パラメータ

戻り値

議論

以下も見よ

関連した文書