IXmlPullParser.NextToken Méthode

[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

Retours

Attributs

RegisterAttribute

Exceptions

Remarques

Cette méthode fonctionne de la même façon que next(), mais expose des types d’événements supplémentaires (COMMENT, CDSECT, DOCDECL, ENTITY_REF, PROCESSING_INSTRUCTION ou IGNORABLE_WHITESPACE) s’ils sont disponibles en entrée.

Si une fonctionnalité spéciale FEATURE_XML_ROUNDTRIP (identifiée par l’URI : http://xmlpull.org/v1/doc/features.html#xml-roundtrip) est activée, il est possible d’effectuer un aller-retour de document XML, par exemple. reproduire l’exectly sur la sortie de l’entrée XML à l’aide de getText() : le contenu retourné est toujours nonnormalisé (exactement comme en entrée). Sinon, le contenu retourné est normalisé en fin de ligne, comme décrit la gestion de fin de ligne XML 1.0 et. En outre, lorsque cette fonctionnalité est activée, le contenu exact de START_TAG, END_TAG, DOCDECL et PROCESSING_INSTRUCTION est disponible.

Voici la liste des jetons qui peuvent être retournés à partir de nextToken() et de getText() et getTextCharacters() retourne :dl dldtSTART_DOCUMENTdd null dtEND_DOCUMENTddnull dtSTART_TAGddnull, sauf si FEATURE_XML_ROUNDTRIP activé, puis retourne la balise XML, ex : < tag attr='val’dt END_TAG ddnull, sauf si FEATURE_XML_ROUNDTRIP ID activé, puis retourne la balise XML, ex : dt TEXTdtreturn element content. <br>Remarque : le contenu de l’élément peut être remis dans plusieurs événements TEXT consécutifs. <dt>IGNORABLE_WHITESPACE<caractères de retour dd>qui sont déterminés à être un espace blanc ignoré. Si le FEATURE_XML_ROUNDTRIP est activé, tout le contenu d’espace blanc en dehors de l’élément racine est toujours signalé comme IGNORABLE_WHITESPACE sinon la création de rapports est facultative. <br>Remarque : le contenu de l’élément peut être remis dans plusieurs événements de IGNORABLE_WHITESPACE consécutifs. dtCDSECTdd retourne du texte eminside/em CDATA (ex. 'fo< o' de < ! CDATA[fo< o]]) dtPROCESSING_INSTRUCTIONdd si FEATURE_XML_ROUNDTRIP est vrai retourner exactement le contenu PI ex : 'pi foo' from < ? pi foo ? sinon, il peut s’agir d’un contenu PI exact ou d’une concaténation de la cible, de l’espace et des données pi, par exemple pour < ? données cibles ? chaîne " données cibles" peut être retourné si FEATURE_XML_ROUNDTRIP a la valeur false. <dt>COMMENT<dd>retourne le contenu du commentaire, par exemple. 'foo bar' de < ! --foo bar--dtENTITY_REFddgetText() DOIT retourner le texte de remplacement de l’entité si PROCESS_DOCDECL a la valeur false sinon getText() PEUT retourner null, en outre getTextCharacters() DOIT retourner le nom d’entité (par exemple « entity_name » pour & entity_name ;). <br><b>REMARQUE :</b> il s’agit du seul endroit où la valeur retournée à partir de getText() et getTextCharacters() <b>sont différentes</b><br><b>REMARQUE :</b> il incombe à l’utilisateur de résoudre la référence d’entité si PROCESS_DOCDECL a la valeur false et qu’il n’y a pas de texte de remplacement d’entité défini dans la méthode defineEntityReplacementText() (getText() sera null) <br><b REMARQUE :</b b>> entités de caractères (ex.  ;) et entités standard telles que & amp ; & lt ; & gt ; & quot ; & apos ; sont également signalés et ne>sont <pas</b> signalés en tant que jetons TEXT, mais en tant que jetons ENTITY_REF ! Cette exigence est ajoutée pour permettre d’effectuer un aller-retour de documents XML ! <dt>DOCDECL<dd> si FEATURE_XML_ROUNDTRIP a la valeur true ou PROCESS_DOCDECL a la valeur false, puis retournez ce qui se trouve à l’intérieur de DOCDECL par exemple :

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

pour le document d’entrée contenu :

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

sinon, si FEATURE_XML_ROUNDTRIP a la valeur false et que PROCESS_DOCDECL a la valeur true, ce qui est retourné est non défini (il peut être même null) </dd></dl>

< >strong REMARQUE :</strong> il n’existe aucune garantie qu’il n’y aura qu’un seul événement TEXT ou IGNORABLE_WHITESPACE de nextToken(), car l’analyseur peut choisir de fournir du contenu d’élément dans plusieurs jetons (divisant le contenu de l’élément en blocs)

<strong>REMARQUE :</strong> si le texte retourné du jeton est normalisé de bout en bout dépend de FEATURE_XML_ROUNDTRIP.

strongREMARQUE :/strong XMLDecl (< ? xml ... ? >) n’est pas signalé, mais son contenu est disponible via des propriétés facultatives (voir la description de classe ci-dessus).

Java documentation pour org.xmlpull.v1.XmlPullParser.nextToken().

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.