IXmlPullParser.NextToken メソッド

  • リファレンス

定義

名前空間:
Org.XmlPull.V1
アセンブリ:
Mono.Android.dll

このメソッドは next() と同様に動作しますが、追加のイベントの種類 (COMMENT、CDSECT、DOCDECL、ENTITY_REF、PROCESSING_INSTRUCTION、またはIGNORABLE_WHITESPACE) が入力で使用可能な場合は公開されます。

[Android.Runtime.Register("nextToken", "()I", "GetNextTokenHandler:Org.XmlPull.V1.IXmlPullParserInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public Org.XmlPull.V1.XmlPullParserNode NextToken ();
[<Android.Runtime.Register("nextToken", "()I", "GetNextTokenHandler:Org.XmlPull.V1.IXmlPullParserInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member NextToken : unit -> Org.XmlPull.V1.XmlPullParserNode

戻り値

XmlPullParserNode
属性
RegisterAttribute

例外

XmlPullParserException
IOException

注釈

このメソッドは next() と同様に動作しますが、追加のイベントの種類 (COMMENT、CDSECT、DOCDECL、ENTITY_REF、PROCESSING_INSTRUCTION、またはIGNORABLE_WHITESPACE) が入力で使用可能な場合は公開されます。

特別な機能 FEATURE_XML_ROUNDTRIP (URI で識別されます: http://xmlpull.org/v1/doc/features.html#xml-roundtrip) が有効になっている場合は、XML ドキュメントのラウンド トリップを実行できます。つまり、getText() を使用して XML 入力を出力時に再現します。返されるコンテンツは常に正規化されていません (入力とまったく同じ)。 それ以外の場合、返されるコンテンツは、「 XML 1.0 End-of-Line Handling and」で説明されているように、行末が正規化されます。 また、この機能が有効になっている場合は、START_TAG、END_TAG、DOCDECL、PROCESSING_INSTRUCTIONの正確なコンテンツを使用できます。

nextToken() から返すことができるトークンの一覧と、getText() と getTextCharacters() が返すトークン<の一覧を次に示します。dl><dt>START_DOCUMENT<dd>null dt END_DOCUMENT dd>null <<dt>>START_TAG<<dd>null が有効になっていない限 FEATURE_XML_ROUNDTRIPり、XML タグ (例: <) が返されます。tag attr='val'dt END_TAG FEATURE_XML_ROUNDTRIP id が有効になっていない限り dd>null になり、xml タグ (例: </tag<>dt>TEXT<dd>return element content) を返します。<><> <br>注: 要素の内容は、複数の連続する TEXT イベントで配信される場合があります。 <dt>IGNORABLE_WHITESPACE<dd>は、無視できる空白であると判断された文字を返します。 FEATURE_XML_ROUNDTRIPが有効になっている場合、ルート要素の外部にあるすべての空白コンテンツは、常にIGNORABLE_WHITESPACE報告されます。それ以外の場合、レポートは省略可能です。 <br>注: 要素のコンテンツは、連続する複数のIGNORABLE_WHITESPACE イベントで配信される場合があります。 <dt>CDSECT<dd> は、CDATA 内<のテキスト <> em>を返します (例: 'fo<o' <!CDATA[fo<o]]>) <dt>PROCESSING_INSTRUCTION<dd> if FEATURE_XML_ROUNDTRIP true の場合は、正確な PI コンテンツを返します (例: <?pi foo?>それ以外の場合は、PI ターゲット、スペース、データの正確な PI コンテンツまたは連結である可能性があるため、たとえば、<?ターゲット データ>文字列 "ターゲット データ"FEATURE_XML_ROUNDTRIPが false の場合は、 が返される場合があります。 <dt>COMMENT<dd>return comment content ex. <!--foo bar---><dt>ENTITY_REF<dd>getText() は、PROCESS_DOCDECLが false の場合はエンティティ置換テキストを返す必要があります。それ以外の場合、getText() は null を返します。さらに、getTextCharacters() はエンティティ名を返す必要があります (たとえば、entity_name &entity_name;)。 <br><b>NOTE:</b> これは、getText() と getTextCharacters() <b>から返される値が異なる<唯一の場所です/b<>br><b>NOTE:</b> PROCESS_DOCDECLが false で、defineEntityReplacementText() メソッド (getText() <にエンティティ置換テキスト セットがない場合は、エンティティ参照を解決する必要があります) br><b>NOTE:</b>文字エンティティ (例: &#32;) と、& などの標準エンティティアンプ;&中尉;&Gt;&;;Quot;&;;apos;は同様に報告され、b>not</b> は <TEXT トークンとして、ENTITY_REF トークンとして報告されます。 この要件は、XML ドキュメントのラウンドトリップを可能にするために追加されています。 <dt>DOCDECL<dd> FEATURE_XML_ROUNDTRIPが true であるか、PROCESS_DOCDECLが false の場合は、DOCDECL 内にあるものを返します。たとえば、次が返されます。

&quot; titlepage SYSTEM "http://www.foo.bar/dtds/typo.dtd"
            [&lt;!ENTITY % active.links "INCLUDE">]&quot;

を含む入力ドキュメントの場合:

&lt;!DOCTYPE titlepage SYSTEM "http://www.foo.bar/dtds/typo.dtd"
            [&lt;!ENTITY % active.links "INCLUDE">]>

それ以外の場合FEATURE_XML_ROUNDTRIPが false で、PROCESS_DOCDECLが true の場合、返される内容は未定義です (null でもかまいません) </dd></dl>

<strong>NOTE:</strong:/strong> は、パーサーが複数のトークン (要素コンテンツをチャンクに分割) で要素コンテンツを配信することを選択する可能性があるため、nextToken() からの TEXT イベントまたはIGNORABLE_WHITESPACE イベントが 1 つしかないという保証はありません。

<厳密な>注:</トークン> の返されたテキストが行末に正規化されているかどうかは、FEATURE_XML_ROUNDTRIPに依存します。

<strong>NOTE:</strong> XMLDecl (<?Xml。。。。>)は報告されませんが、そのコンテンツは省略可能なプロパティを使用して使用できます (上記のクラスの説明を参照してください)。

の org.xmlpull.v1.XmlPullParser.nextToken()Java ドキュメント。

このページの一部は、によって作成および共有された作業に基づく変更であり、に記載されている条件に従って使用されます。

適用対象