GXml.Element – gxml-0.20 Reference Manual

Element

Object Hierarchy:

Description:

public class Element : Node, DomChildNode, DomNonDocumentTypeChildNode, DomParentNode, DomElement, Object

A DOM4 implementation of DomElement, for one-step-parsing.

This object avoids pre and post XML parsing, by using a one step parsing to translate text XML tree to an GObject based tree.

A GXml Object Model (GOM) implementation of GXml.Element. It can be used transparently as DomElement in a XML tree.

It also allows delayed parsing, so you can read large documents by parsing just a XML element node and its attributes but not its children; save its children as a text, for a post-on-step-parsing.

All known sub-classes:

Namespace: GXml

Package: gxml-0.20

Content:

Classes:

Attributes - Holds attributes in current node, using attribute's name as key and it's value as value. Appends namespace prefix to attribute's name as key if is a namespaced attribute.

Properties:

public bool parse_children { get; set; }
If true all children are parsed. If false, all its children are stored as plain string in unparsed. In order to generate an XML tree use read_unparsed.
public MemoryOutputStream read_buffer { get; set; }
On memory GLib.MemoryOutputStream with the unparsed string of the element
public string unparsed { get; set; }
Temporally stores, all unparsed children as plain string. See parse_children.

Creation methods:

public Element ()

Methods:

public void initialize (string local_name)
Convenient function to initialize, at construction time, a GXml.Element using given local name. If GXml.Element.initialize_with_namespace has been called in any base class, this method just change element node's name and keeps previous namespace and prefix.
public void initialize_document (DomDocument doc, string local_name)
Convenient function to initialize, at construction time, a GXml.Element using given local name and document.
public void initialize_document_with_namespace (DomDocument doc, string? namespace_uri, string? prefix, string local_name)
Convenient function to initialize, at construction time, a GXml.Element using given local name, document and namespace.
public void initialize_with_namespace (string? namespace_uri, string? prefix, string local_name)
Convenient function to initialize, at construction time, a GXml.Element using given local name and namespace.
public string? lookup_namespace_uri (string? prefix)
public string? lookup_prefix (string? nspace)
public void parse_buffer () throws Error
Synchronically parse read_buffer
public async void parse_buffer_async () throws Error
Asynchronically parse read_buffer
public uint parse_pending ()
Monitor multi-threading parsing
public void read_unparsed () throws Error
Parse all children, adding them to current node, stored in unparsed. Once it finish, sets unparsed to null.

Fields:

protected Attributes _attributes
Reference to Attributes for element's attributes. Derived classes should avoid to modify it.
protected string _namespace_uri
Use this field to set node's namespace URI. Can used to set it at construction time.