domdocument.createelement(3) php man page | unix.com

DOMDOCUMENT.CREATEELEMENT(3)						 1					      DOMDOCUMENT.CREATEELEMENT(3)

DOMDocument::createElement - Create new element node

SYNOPSIS

       public DOMElement DOMDocument::createElement (string  $name, [string  $value])

DESCRIPTION

	This  function	creates  a  new instance of class DOMElement. This node will not show up in the document unless it is inserted with (e.g.)
       DOMNode.appendChild(3).

PARAMETERS

	      o $name
		- The tag name of the element.

	      o $value
		- The value of the element. By default, an empty element will be created. The value can also be set later with	DOMElement::$node-
		Value.

RETURN VALUES

	Returns a new instance of class DOMElement or FALSE if an error occurred.

ERRORS
/EXCEPTIONS
	      o DOM_INVALID_CHARACTER_ERR - Raised if $name contains an invalid character.

EXAMPLES

       Example #1

	      Creating a new element and inserting it as root

	      <?php

	      $dom = new DOMDocument('1.0', 'utf-8');

	      $element = $dom->createElement('test', 'This is the root element!');

	      // We insert the new element as root (child of the document)
	      $dom->appendChild($element);

	      echo $dom->saveXML();
	      ?>

	      The above example will output:

	      <?xml version="1.0" encoding="utf-8"?>
	      <test>This is the root element!</test>

NOTES

       Note

	       The $value will not be escaped. Use DOMDocument::createTextNode to create a text node with escaping support.

SEE ALSO

       DOMNode::appendChild,  DOMDocument::createAttribute,  DOMDocument::createAttributeNS, DOMDocument::createCDATASection, DOMDocument::create-
       Comment,  DOMDocument::createDocumentFragment,  DOMDocument::createElementNS,  DOMDocument::createEntityReference,  DOMDocument::createPro-
       cessingInstruction, DOMDocument::createTextNode.

PHP Documentation Group 											      DOMDOCUMENT.CREATEELEMENT(3)