XML:append(name [, text [, attributes [, go]]])

Fügt dem Dokument unmittelbar nach dem aktuellen Element eine neues Element als gleichgeordnetes Element hinzu.

Wenn Text angegeben wird, enthält das Element einen Textknoten, der auf den Wert der Textzeichenfolge gesetzt ist.

Das optionale Argument 'attributes' ist eine Tabelle, die eine Gruppe von Name/Wert-Paaren enthalten sollte. Die Tabelle wird verwendet, um die Attribute des neuen XML-Elements festzulegen.

Das vierte Argument ist ein boolescher Wert. Wenn es den Wert true hat, wird die Dokumentposition auf das neu erstellte Element gesetzt. Andernfalls wird die Dokumentposition nicht geändert.

Beispiel

attrs={}
attrs.hostname='127.0.0.1'
attrs.port='5480'
attrs.database='system'

doc = xml.parse('<options><date>2011-07-01</date></options>')
doc:goPath('/options/date')
doc:append('connection', null, attrs, true)