語言

ValidatorHandler.Characters(Char[], Int32, Int32) 方法

定義

接收角色資料通知。

[Android.Runtime.Register("characters", "([CII)V", "GetCharacters_arrayCIIHandler")]
public abstract void Characters(char[]? ch, int start, int length);
[<Android.Runtime.Register("characters", "([CII)V", "GetCharacters_arrayCIIHandler")>]
abstract member Characters : char[] * int * int -> unit

參數

ch
Char[]

來自 XML 文件的字元

start
Int32

陣列中的起始位置

length
Int32

從陣列中讀取的字元數

實作

屬性

備註

接收角色資料通知。

解析器會呼叫此方法來報告每一個字元資料區塊。 SAX 解析器可能會將所有連續的字元資料匯成單一區塊,或將其拆分成數個區塊;然而,任何單一事件中的所有字元都必須來自同一個外部實體,這樣定位器才能提供有用的資訊。

應用程式不得嘗試從陣列讀取超出指定範圍的資訊。

單一字元可能包含多個 Java char 值。 有兩個重要的情況會發生這種情況,因為角色無法僅用十六位元來呈現。 在一種情況下,字元以 <em>代言對/<em> 表示,使用兩個特殊的 Unicode 值。 這類字元位於所謂的「星界平面」,代碼點位於 U+FFFF 之上。 第二種情況是複合角色,例如基礎角色與一個或多個重音符號結合。

你的程式碼不應假設使用 char-at-it-a-time 慣用法的演算法會在字元單位中運作;在某些情況下,它們會拆分字元。 這點適用於 XML 允許任意字元,例如屬性值、處理指令資料和註解,以及此方法報告的資料中。 當 Java 程式碼處理國際化文字時,這通常也很重要;這個問題並非 XML 獨有。

請注意,有些解析器會用這個#ignorableWhitespace ignorableWhitespace方法報告元素內容空白(驗證解析器<>必須</>他們會這麼做)。

org.xml.sax.ContentHandler.characters(char[], int, int)Java 檔。

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

適用於