XmlGetValueAlpha

obj -> XmlGetValueAlpha(int1]) : alpha

Ermittelt eine alphanumerische Eigenschaft eines XML-Knotens oder einer -Datei

Details

• obj: Deskriptor des XmlReader-Objektes
• int1:
  • Zu ermittelnder Wert:
  • _XmlVersion
  • _XmlGetEncoding
  • _XmlGetName
  • _XmlGetValue
• Resultat: alpha Wert abhängig von der angegebenen Option oder ein Leerstring bei einem Fehler.
• Siehe: Verwandte Befehle , XmlRead () , XmlGetValueInt ()

Dieser Befehl liefert Informationen zu einem mit XmlRead () gelesenen Knoten in der XML-Datei (obj).

Je nach Option (int1) können andere Werte zurückgegeben werden:

• Option: Beschreibung
• _XmlGetVersion ( 1 ): XML-Version - Dieser Wert steht nach dem ersten XmlRead () zur Verfügung.
• _XmlGetEncoding ( 2 ): Kodierung - Dieser Wert steht nach dem ersten XmlRead () zur Verfügung.
• _XmlGetName ( 3 ): Name des Knotens
• _XmlGetValue ( 4 ): Inhalt des Knotens

info

Die Zeichenketten sind UTF-8 kodiert.

Ist ein Fehler aufgetreten wird eine leere Zeichenkette zurückgegeben.

Beispiel:

// XmlReader öffnen
tXmlReader # XmlOpenReader('C:\File.xml', 'C:\Schema.xml');
if (tXmlReader > 0)
{
  // Alle Knoten der XML-Datei durchgehen
  while (tXmlReader->XmlRead() = _ErrOk)
  {
    if (!tNotFirst)
    {
      tVersion      # tXmlReader->XmlGetValueAlpha(_XmlGetVersion);
      tEncoding     # tXmlReader->XmlGetValueAlpha(_XmlGetEncoding);
      tIsStandalone # tXmlReader->XmlGetValueInt(_XmlIsStandalone);
      tNotFirst     # true;
    }

    // Knoten verarbeiten
    tType   # tXmlReader->XmlGetValueInt(_XmlGetType);
    switch (tType)
    {
      case _XmlReaderTypePI :
      {
        tPIName  # tXmlReader->XmlGetValueAlpha(_XmlGetName);
        tPIValue # tXmlReader->XmlGetValueAlpha(_XmlGetValue);
      }
      case _XmlReaderTypeDocumentType :
        tDocType # tXmlReader->XmlGetValueAlpha(_XmlGetValue);
      case _XmlReaderTypeComment :
        tComment = tXmlReader->XmlGetValueAlpha(_XmlGetValue);
      case _XmlReaderTypeElement :
      {
        tName  # tXmlReader->XmlGetValueAlpha(_XmlGetName);
        tValue # tXmlReader->XmlGetValueAlpha(_XmlGetValue);
        tAttribCount # tXmlReader->XmlGetValueInt(_XmlGetAttribCount);
        if (tAttribCount > 0)
        {
          // Alle Attributknoten des aktuellen Knotens durchgehen
          do
          {
            tXmlReader->XmlRead(_XmlReadAttribNode);
            tAttribName  # tXmlReader->XmlGetValueAlpha(_XmlGetName);
            tAttribValue # tXmlReader->XmlGetValueAlpha(_XmlGetValue);
            Dec(tAttribCount);
          }
          while (tAttribCount > 0);
        }
      }
    }
  }

  // XmlReader schließen
  tXmlReader->XmlClose();
}

Mögliche Laufzeitfehler:

• _ErrHdlInvalid: Der Deskriptor (obj) ist kein XmlReader-Deskriptor.
• _ErrValueInvalid: Die angegebene Option (int1) ist ungültig.
• _ErrValueRange: Ermittelter Wert ist länger als 65.520 Zeichen.