This function is used to either create new tags in Free-form XML document instances or to create foreign namespace tags in XML documents. The qname parameter provides the name of the new tag with an optional prefix. The uri parameter, if supplied, specifies the URI for the new tag. If it is not specified, then the target namespace for the document is used (none for a Free-form XML document). If the empty parameter is supplied and not zero, then the element is not allowed to have content.

The function returns 1 on success.

If the doc parameter is 0 or omitted, then the current document is used.