語言

Locale.LanguageRange.Parse 方法

定義

命名空間:
Java.Util
組件:
Mono.Android.dll

多載

名稱 Description
Parse(String)

解析給定 ranges 的條件以產生語言優先清單。
Parse(String, IDictionary<String,IList<String>>)

解析給定 ranges 資料以產生語言優先清單，然後利用給定 map的 進行自訂清單。

Parse(String)

解析給定 ranges 的條件以產生語言優先清單。

[Android.Runtime.Register("parse", "(Ljava/lang/String;)Ljava/util/List;", "", ApiSince=26)]
public static System.Collections.Generic.IList<Java.Util.Locale.LanguageRange> Parse(string ranges);
[<Android.Runtime.Register("parse", "(Ljava/lang/String;)Ljava/util/List;", "", ApiSince=26)>]
static member Parse : string -> System.Collections.Generic.IList<Java.Util.Locale.LanguageRange>

參數

ranges
String

一個逗號分隔的語言範圍清單，或是以 RFC 2616 定義的「Accept-Language」標頭形式的語言範圍列表

傳回

IList<LanguageRange>

語言優先清單，包含所包含 ranges 的語言範圍及其對應語言範圍（如有）。 這個清單是可以修改的。

屬性
RegisterAttribute

備註

解析給定 ranges 的條件以產生語言優先清單。

此方法對給定 ranges 語言範圍中的每個範圍進行語法檢查，但不使用 IANA 語言子標籤登錄檔進行驗證。

所給出的 ranges 可呈現以下形式之一：

"Accept-Language: ja,en;q=0.4"  (weighted list with Accept-Language prefix)
              "ja,en;q=0.4"                   (weighted list)
              "ja,en"                         (prioritized list)

在加權列表中，每個語言範圍都會被賦予權重值。 權重值與 RFC 2616 中的「品質值」相同，並表達使用者對該語言的偏好程度。 權重值會在對應語言範圍後接 ";q="後指定，預設權重值則是 MAX_WEIGHT 省略該區間時。

與加權清單不同，優先排序清單中的語言範圍會依優先順序由低排序。 第一種語言範圍優先權最高，最符合使用者的偏好。

無論哪種情況，語言範圍都會依優先順序或權重依序在語言優先清單中排序。 如果某個語言範圍在指定 ranges 中出現多次，則只有第一個範圍會被納入語言優先清單。

回傳的列表包含上述 ranges 語言範圍及其在 IANA 語言子標籤登錄中所找到的對應詞。 例如，若給定 ranges 為 "Accept-Language: iw,en-us;q=0.7,en;q=0.3"，則回傳的清單元素為：

<b>Range</b>                                   <b>Weight</b>
               "iw" (older tag for Hebrew)             1.0
               "he" (new preferred code for Hebrew)    1.0
               "en-us" (English, United States)        0.7
               "en" (English)                          0.3

兩個語言範圍 "iw" 和 "he"在列表中擁有相同的最高優先權。 透過將區域匹配方法加入 "he" 使用者的語言優先清單，即使應用程式或系統僅 "he" 提供支援區域（或語言標籤），也能找到希伯來語作為匹配區域（或語言標籤）。

Java 文件 java.util.Locale.LanguageRange.parse(java.lang.String)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於

Parse(String, IDictionary<String,IList<String>>)

解析給定 ranges 資料以產生語言優先清單，然後利用給定 map的 進行自訂清單。

[Android.Runtime.Register("parse", "(Ljava/lang/String;Ljava/util/Map;)Ljava/util/List;", "", ApiSince=26)]
public static System.Collections.Generic.IList<Java.Util.Locale.LanguageRange> Parse(string ranges, System.Collections.Generic.IDictionary<string,System.Collections.Generic.IList<string>> map);
[<Android.Runtime.Register("parse", "(Ljava/lang/String;Ljava/util/Map;)Ljava/util/List;", "", ApiSince=26)>]
static member Parse : string * System.Collections.Generic.IDictionary<string, System.Collections.Generic.IList<string>> -> System.Collections.Generic.IList<Java.Util.Locale.LanguageRange>

參數

ranges
String

一個逗號分隔的語言範圍清單，或是以 RFC 2616 定義的「Accept-Language」標頭形式的語言範圍列表

map
IDictionary<String,IList<String>>

一張包含可自訂語言範圍資訊的地圖

傳回

IList<LanguageRange>

一個具備自訂功能的語言優先清單。 這個清單是可以修改的。

屬性
RegisterAttribute

備註

解析給定 ranges 資料以產生語言優先清單，然後利用給定 map的 進行自訂清單。 此方法等價於 mapEquivalents(parse(ranges), map)。

Java 文件 java.util.Locale.LanguageRange.parse(java.lang.String, java.util.Map<java.lang.String, java.util.List<java.lang.String>>)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於