CharsetEncoder 類別

定義

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

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

繼承

Object

JavaObject

Object

CharsetEncoder

屬性

RegisterAttribute

備註

可將十六位 Unicode 字元序列轉換成特定字元集中位元組序列的引擎。

“steps”>

輸入字元序列是在字元緩衝區或一系列這類緩衝區中提供。 輸出位元組序列會寫入位元組緩衝區或一系列這類緩衝區。 一律應該使用編碼器，方法是進行下列方法調用序列，以下簡稱 編碼作業：

<老>

<李>

除非之前尚未使用編碼器，否則請透過 #reset reset 方法重設編碼器;

</李>

<李>

#encode encode叫用方法零次或多次，只要有其他輸入可用，傳遞false自endOfInput變數並填入輸入緩衝區，並在調用之間排清輸出緩衝區;

</李>

<李>

#encode encode叫用方法最後一次，傳遞true自endOfInput變數;然後

</李>

<李>

#flush flush叫用 方法，讓編碼器可以將任何內部狀態排清至輸出緩衝區。

</李>

</老>

方法的每個調用 #encode encode 都會盡可能從輸入緩衝區編碼任意數目的字元，並將產生的位元組寫入輸出緩衝區。 當 #encode encode 需要更多輸入、輸出緩衝區中沒有足夠的空間，或發生編碼錯誤時，方法會傳回 。 在每個情況下，都會 CoderResult 傳回 物件來描述終止的原因。 叫用程式可以檢查此物件並填入輸入緩衝區、排清輸出緩衝區，或視需要嘗試從編碼錯誤中復原，然後再試一次。

“ce”>

編碼錯誤的一般類型有兩種。 如果輸入字元序列不是合法的十六位 Unicode 序列，則輸入會被視為 格式不正確。 如果輸入字元序列合法，但無法對應至指定字元集中的有效位元組序列，則 遇到無法套用的字元 。

“cae”>

編碼錯誤處理方式取決於針對該錯誤類型所要求的動作，而該動作是由 類別的 CodingErrorAction 實例所描述。 可能的錯誤動作是，CodeErrorAction#IGNORE 忽略錯誤的輸入，CodeErrorAction#REPORT 會透過傳 CoderResult 回的物件向叫用者報告錯誤，或 CodeErrorAction#REPLACE 將錯誤的輸入取代為取代位元組陣列的目前值。 取代專案

一開始會設定為編碼器的預設取代專案，通常（但不一定）具有初始值 { (byte)'?' };

其值可能透過 #replaceWith(byte[]) replaceWith 方法變更。

格式不正確輸入和無法套用字元錯誤的默認動作是將錯誤報告給 CodeErrorAction#REPORT。 格式錯誤的輸入錯誤動作可以透過 #onMalformedInput(CodingErrorAction) onMalformedInput 方法變更;無法套用的字元動作可以透過 #onUnmappableCharacter(CodingErrorAction) onUnmappableCharacter 方法變更。

此類別的設計目的是要處理編碼程式的許多詳細數據，包括錯誤動作的實作。 特定 charset 的編碼器，這是這個類別的具體子類別，只需要實作抽象 #encodeLoop encodeLoop 方法，其會封裝基本編碼迴圈。 維護內部狀態的子類別應該另外覆寫 #implFlush implFlush 和 #implReset implReset 方法。

這個類別的實例無法安全供多個並行線程使用。

已在1.4中新增。

的 java.nio.charset.CharsetEncoderJava 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。