FB_XmlDomParser

FB_XmlDomParser 1:
FB_XmlDomParser 2:

Strings im UTF-8-Format

Die hier verwendeten Variablen vom Typ STRING nutzen das UTF-8-Format. Diese STRING-Formatierung ist üblich bei IoT/MQTT-Kommunikation sowie JSON-Dokumenten.

Um Sonderzeichen und Texte verschiedenster Sprachen empfangen zu können, wird der Zeichensatz in den Bibliotheken Tc3_IotBase und Tc3_JsonXml nicht auf den typischen Zeichensatz vom Datentyp STRING beschränkt. Stattdessen wird der Unicode-Zeichensatz als UTF-8-Format in Verbindung mit dem Datentyp STRING verwendet.

Bei Verwendung des ASCII-Zeichensatzes besteht kein Unterschied zwischen der typischen Formatierung in einem STRING und der UTF-8-Formatierung eines STRING.

Weitere Informationen zum UTF-8-STRING-Format sowie vorhandenen Anzeige- und Konvertierungsmöglichkeiten finden Sie in der Dokumentation der SPS-Bibliothek Tc2_Utilities.

FB_XmlDomParser 3: Ausgänge

Name

Typ

initStatus

HRESULT

FB_XmlDomParser 4: Methoden

Name

Beschreibung

AppendAttribute

Fügt ein neues Attribut zu einem existierenden Knoten hinzu.

AppendAttributeAsBool

Fügt ein neues Attribut zu einem existierenden Knoten hinzu (Boolean).

AppendAttributeAsDouble

Fügt ein neues Attribut zu einem existierenden Knoten hinzu (Double).

AppendAttributeAsFloat

Fügt ein neues Attribut zu einem existierenden Knoten hinzu (Float).

AppendAttributeAsInt

Fügt ein neues Attribut zu einem existierenden Knoten hinzu (Integer).

AppendAttributeAsLint

Fügt ein neues Attribut zu einem existierenden Knoten hinzu (Integer64).

AppendAttributeAsUint

Fügt ein neues Attribut zu einem existierenden Knoten hinzu (Unsigned Integer).

AppendAttributeAsUlint

Fügt ein neues Attribut zu einem existierenden Knoten hinzu (Unsigned Integer64).

AppendAttributeCopy

Fügt ein neues Attribut zu einem existierenden Knoten hinzu.

AppendChild

Fügt einen neuen Knoten unterhalb eines existierenden Knotens ein.

AppendChildAsBool

Fügt einen neuen Knoten unterhalb eines existierenden Knotens ein (Boolean).

AppendChildAsDouble

Fügt einen neuen Knoten unterhalb eines existierenden Knotens ein (Double).

AppendChildAsFloat

Fügt einen neuen Knoten unterhalb eines existierenden Knotens ein (Float).

AppendChildAsInt

Fügt einen neuen Knoten unterhalb eines existierenden Knotens ein (Integer).

AppendChildAsLint

Fügt einen neuen Knoten unterhalb eines existierenden Knotens ein (Integer64).

AppendChildAsUint

Fügt einen neuen Knoten unterhalb eines existierenden Knotens ein (Unsigned Integer).

AppendChildAsUlint

Fügt einen neuen Knoten unterhalb eines existierenden Knotens ein (Unsigned Integer64).

AppendCopy

Fügt einen neuen Knoten unterhalb eines existierenden Knotens ein.

AppendNode

Fügt einen neuen Knoten unterhalb eines existierenden Knotens ein.

Attribute

Liest das Attribut eines gegebenen XML-Knotens aus.

AttributeAsBool

Liefert den Wert eines Attributs als Datentyp Boolean.

AttributeAsDouble

Liefert den Wert eines Attributs als Datentyp Double.

AttributeAsFloat

Liefert den Wert eines Attributs als Datentyp Float.

AttributeAsInt

Liefert den Wert eines Attributs als Datentyp Integer.

AttributeAsLint

Liefert den Wert eines Attributs als Datentyp Integer64.

AttributeAsUint

Liefert den Wert eines Attributs als Datentyp Unsigned Integer.

AttributeAsUlint

Liefert den Wert eines Attributs als Datentyp Unsigned Integer64.

AttributeBegin

Liefert einen Iterator über alle Attribute eines XML-Knotens.

AttributeFromIterator

Konvertiert die aktuelle Position eines Iterators in ein XML-Attribut-Objekt.

AttributeName

Liefert den Namen eines gegebenen Attributs.

Attributes

Dient zur Navigation durch den DOM und liefert einen Iterator auf alle gefundenen Attribute an einem XML-Knoten zurück.

AttributeText

Liefert den Text eines gegebenen Attributs.

Begin

Liefert einen Iterator über alle Kindelemente eines XML‑Knotens.

BeginByName

Liefert einen Iterator über alle Kindelemente eines XML-Knotens, beginnend ab einem bestimmten Element.

Child

Dient zur Navigation durch den DOM und liefert eine Referenz auf das (erste) Kindelement des aktuellen Knotens zurück.

ChildByAttribute

Dient zur Navigation durch den DOM und liefert eine Referenz auf ein Kindelement im XML-Dokument zurück.

ChildByAttributeAndName

Dient zur Navigation durch den DOM und liefert eine Referenz auf ein Kindelement im XML-Dokument zurück.

ChildByName

Dient zur Navigation durch den DOM und liefert eine Referenz auf ein Kindelement im XML-Dokument zurück.

Children

Dient zur Navigation durch den DOM und liefert einen Iterator auf mehrere gefundene Kindelemente im XML-Dokument zurück.

ChildrenByName

Dient zur Navigation durch den DOM und liefert einen Iterator auf mehrere gefundene Kindelemente im XML-Dokument zurück.

ClearIterator

Diese Methode setzt bereits verwendete Iteratoren zurück, sodass diese bei dem nächsten Programmdurchlauf wieder verwendet werden können.

Compare

Überprüft zwei Iteratoren auf Gleichheit.

CopyAttributeText

Liest den Wert eines XML-Attributs aus und schreibt diesen in eine Variable vom Datentyp String.

CopyDocument

Kopiert den Inhalt des DOM-Speichers in eine Variable vom Datentyp String.

CopyNodeText

Liest den Wert eines XML-Knotens aus und schreibt diesen in eine Variable vom Datentyp String.

CopyNodeXml

Liest die XML-Struktur eines XML-Knotens aus und schreibt diese in eine Variable vom Datentyp String.

End

 

FirstNodeByPath

Navigiert anhand eines an die Methode übergebenen Pfads durch ein XML‑Dokument.

GetAttributeTextLength

Liefert die Länge des Werts eines XML-Attributs.

GetDocumentLength

Liefert die Länge eines XML-Dokuments in Bytes.

GetDocumentNode

Liefert den Root-Knoten eines XML-Dokuments.

GetNodeTextLength

Liefert die Länge des Werts eines XML-Knotens.

GetNodeXmlLength

Liefert die Länge der XML-Struktur eines XML-Knotens.

GetRootNode

Liefert eine Referenz zum ersten XML-Knoten im XML-Dokument.

InsertAttributeCopy

Fügt ein Attribut zu einem XML-Knoten hinzu und kopiert hierbei den Namen und den Wert eines existierenden Attributs.

InsertAttribute

Fügt ein Attribut zu einem XML-Knoten hinzu.

InsertChild

Fügt einen Knoten zu einem existierenden XML-Knoten hinzu.

InsertCopy

Fügt einen neuen Knoten zu einem existierenden XML Knoten hinzu und kopiert hierbei einen existierenden Knoten.

IsEnd

Überprüft, ob sich ein gegebener XML-Iterator am Ende der zu durchlaufenden Iteration befindet.

LoadDocumentFromFile

Lädt ein XML-Dokument aus einer Datei.

NewDocument

Erzeugt ein leeres XML-Dokument im DOM-Speicher.

Next

Setzt einen XML-Iterator auf das nächste zu durchlaufende Objekt.

NextAttribute

Liefert zu einem gegebenen XML-Attribut das nächste Attribut.

NextByName

Setzt einen XML-Iterator auf das nächste zu durchlaufende Objekt, das anhand seines Namens identifiziert wird.

NextSibling

Liefert zu einem gegebenen XML-Knoten den nächsten direkten Knoten auf derselben XML-Ebene.

NextSiblingByName

Liefert zu einem gegebenen XML-Knoten den nächsten direkten Knoten mit einem bestimmten Namen auf derselben XML-Ebene.

Node

Wird in Zusammenhang mit einem Iterator verwendet, um durch den DOM zu navigieren.

NodeAsBool

Liefert den Text eines XML-Knotens als Datentyp Boolean.

NodeAsDouble

Liefert den Text eines XML-Knotens als Datentyp Double.

NodeAsFloat

Liefert den Text eines XML-Knotens als Datentyp Float.

NodeAsInt

Liefert den Text eines XML-Knotens als Datentyp Integer.

NodeAsLint

Liefert den Text eines XML-Knotens als Datentyp Integer64.

NodeAsUint

Liefert den Text eines XML-Knotens als Datentyp Unsigned Integer.

NodeAsUlint

Liefert den Text eines XML-Knotens als Datentyp Unsigned Integer64.

NodeName

Gibt den Namen eines XML-Knotens zurück.

NodeText

Liefert den Text eines XML-Knotens.

ParseDocument

Lädt ein XML-Dokument zur weiteren Verarbeitung in den DOM-Speicher.

RemoveAttribute

 

RemoveAttributeByName

 

RemoveChild

entfernt einen XML-Kindknoten von einem gegebenen XML-Knoten.

RemoveChildByName

Entfernt einen XML-Kindknoten von einem gegebenen XML-Knoten.

SaveDocumentToFile

Speichert das aktuelle XML-Dokument in einer Datei.

SetAttribute

Setzt den Wert eines Attributs.

SetAttributeAsBool

Setzt den Wert eines Attributs (Boolean).

SetAttributeAsDouble

Setzt den Wert eines Attributs (Double).

SetAttributeAsFloat

Setzt den Wert eines Attributs (Float).

SetAttributeAsInt

Setzt den Wert eines Attributs (Integer).

SetAttributeAsLint

Setzt den Wert eines Attributs (Integer64).

SetAttributeAsUint

Setzt den Wert eines Attributs (Unsigned Integer).

SetAttributeAsUlint

Setzt den Wert eines Attributs (Unsigned Integer64).

SetChild

Setzt den Wert eines XML-Knotens (String).

SetChildAsBool

Setzt den Wert eines XML-Knotens (Boolean).

SetChildAsDouble

Setzt den Wert eines XML-Knotens (Double).

SetChildAsFloat

Setzt den Wert eines XML-Knotens (Float).

SetChildAsInt

Setzt den Wert eines XML-Knotens (Integer).

SetChildAsLint

Setzt den Wert eines XML-Knotens (Integer64).

SetChildAsUint

Setzt den Wert eines XML-Knotens (Unsigned Integer).

SetChildAsUlint

Setzt den Wert eines XML-Knotens (Unsigned Integer64).

Voraussetzungen

TwinCAT Version

Hardware

Einzubindende Bibliotheken

TwinCAT 3.1, Build 4022

x86, x64, ARM

Tc3_JsonXml