CharsetDecoder 類別

定義

[Android.Runtime.Register("java/nio/charset/CharsetDecoder", DoNotGenerateAcw=true)]
public abstract class CharsetDecoder : Java.Lang.Object

[<Android.Runtime.Register("java/nio/charset/CharsetDecoder", DoNotGenerateAcw=true)>]
type CharsetDecoder = class
    inherit Object

繼承

Object

JavaObject

Object

CharsetDecoder

屬性

RegisterAttribute

備註

一個能將特定字元組序列轉換為十六位元 Unicode 字元序列的引擎。

「步數」>

輸入位元組序列提供於位元組緩衝區或一系列此類緩衝區中。 輸出字元序列會寫入一個字元緩衝區或一系列此類緩衝區。 解碼器應始終透過以下方法呼叫序列來使用，以下稱為 解碼操作：

<進攻線>

<李>

除非之前未曾使用過，否則請透過該 #reset reset 方法重置解碼器;

</李>

<李>

呼叫#decode decode方法零次或多次，只要還有額外輸入可用，並傳遞falseendOfInput參數並填滿輸入緩衝區，並在呼叫間清除輸出緩衝區;

</李>

<李>

最後一次呼叫該 #decode decode 方法，通過 true 參數 endOfInput ;然後

</李>

<李>

呼叫該 #flush flush 方法，讓解碼器能將任何內部狀態沖刷到輸出緩衝區。

</李>

</ol>

每次呼叫該 #decode decode 方法都會從輸入緩衝區解碼盡可能多的位元組，並將產生的字元寫入輸出緩衝區。 當需要更多輸入、輸出緩衝區空間不足，或發生解碼錯誤時，該 #decode decode 方法會回傳。 每次都會回傳一個 CoderResult 物件來描述終止的原因。 呼叫者可以檢查此物件並填充輸入緩衝區、清除輸出緩衝區，或嘗試從解碼錯誤中恢復，視情況而定，然後再嘗試。

「CE」>

解碼錯誤大致有兩種類型。 如果輸入位元組序列對此字元集不合法，則該輸入被視為 格式錯誤。 如果輸入的位元組序列是合法的，但無法映射到有效的 Unicode 字元，則遇到 了無法映射的字元 。

「凱」>

解碼錯誤的處理方式取決於該類型錯誤所請求的動作，而該動作由該 CodingErrorAction 類別的實例描述。 可能的錯誤操作包括：CodingErrorAction#IGNORE 忽略錯誤輸入、CodingErrorAction#REPORT 透過回傳 CoderResult 物件向呼叫者回報錯誤，或 CodingErrorAction#REPLACE 替換錯誤輸入為替換字串的當前值。 替代

具有初始值 "\uFFFD";

其值可透過該 #replaceWith(java.lang.String) replaceWith 方法進行變更。

對於輸入錯誤和無法映射字元錯誤的預設動作是 CodingErrorAction#REPORT 回報它們。 錯誤輸入動作可透過 #onMalformedInput(CodingErrorAction) onMalformedInput 此方法變更;不可映射字元動作可透過該 #onUnmappableCharacter(CodingErrorAction) onUnmappableCharacter 方法更改。

此類別設計用來處理解碼過程中的許多細節，包括錯誤動作的實作。 針對特定字元集的解碼器，是該類別的具體子類，只需實作 #decodeLoop decodeLoop 抽象方法，該方法封裝了基本的解碼迴圈。 維持內部狀態的子類別也應該覆蓋 #implFlush implFlush 和 #implReset implReset 方法。

此類別的實例不適合多個並行執行緒使用。

在 1.4 版本加入。

Java 文件 java.nio.charset.CharsetDecoder。

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