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. いくつかの識別子からなる配列、それぞれがバンドルがサポートできるローカライゼーションの1つに相当します。

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の中の値の1つを返します。

Discussion 議論

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

  • 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 ローカライズされた情報の取得