Type Method 型メソッド

preferredLocalizationsFromArray:forPreferences:

Returns locale identifiers for which a bundle would provide localized content, given a specified list of candidates for a user's language preferences. ユーザの言語環境設定に対する候補のある指定されたリストを与えられて、ロケール識別子を返します、それに対してバンドルがローカライズされた内容を提供します。

Declaration 宣言 

+ (NSArray<NSString *> *)preferredLocalizationsFromArray:(NSArray<NSString *> *)localizationsArray 
                                          forPreferences:(NSArray<NSString *> *)preferencesArray;

Parameters パラメータ

localizationsArray

An array of identifiers, each corresponding to a localization that a bundle can support. いくつかの識別子からなる配列、それぞれがバンドルがサポートできるローカライゼーションの１つに相当します。

preferencesArray

An array of BCP 47 language codes corresponding to a user's preferred languages. BCP 47言語コードの配列は、ユーザの環境設定言語に相当します。

If this parameter is nil, the method uses the current user's language preferences. パラメータがnilならば、メソッドは現在のユーザの持つ言語環境設定を使います。

Return Value 戻り値

An array of locale identifiers, ordered according to user preference. ロケール識別子からなる配列、ユーザ環境設定に従って並べられます。

If none of the user-preferred localizations are available, this method returns one of the values in localizationsArray. ユーザ環境設定のローカライゼーションのうちのどれも利用可能でないならば、このメソッドはlocalizationsArrayの中の値の１つを返します。

Discussion 議論

This method returns only the locale identifiers for which a bundle would provide localized content. Typically, this means one of the following: 一般的に、これは以下のうちの１つを意味します：

  • A single localization that isn't region-specific 単一の地域特有でないローカライゼーション

  • A region-specific localization, followed by a corresponding localization that isn't region-specific, as a fallback ある地域特有のローカライゼーション、それに続けて相当する地域特有でないローカライゼーションが続きます、予備として。

This method doesn't return all localizations in order of user preference. To get this information, you can call this method repeatedly, each time removing the identifiers returned by the previous call. このメソッドは、すべてのローカライゼーションをユーザ環境設定の順番で返すことはしません。この情報を得るために、あなたは、毎回前の呼び出しによって返される識別子を削除しながら、このメソッドを繰り返し呼び出すことができます。

See Also 参照

Getting Localization Information ローカライズされた情報の取得

localizations
A list of all the localizations contained in the bundle. バンドルの中に含まれるローカライゼーション全てのリスト。
preferredLocalizations
An ordered list of preferred localizations contained in the bundle. バンドルの中に含まれる優先ローカライゼーションの順序リスト。
developmentLocalization
The localization for the development language. 開発言語のローカライゼーション。
localizedInfoDictionary
A dictionary with the keys from the bundle’s localized property list. バンドルの持つローカライズプロパティリストからのキーを持つ辞書。
+ preferredLocalizationsFromArray:
Returns one or more localizations from the specified list that a bundle object would use to locate resources for the current user. バンドルオブジェクトが現在のユーザのためのリソースを捜し出すために使う指定されたリストからひとつ以上のローカライゼーションを返します。