DOMDocument->createElement()

DOMDocument->createElement() -- Create new element node

Leírás

class DOMDocument {

DOMElement createElement ( string name [, string value] )

}

This function creates a new instance of class DOMElement. Ez a csomópont nem fog látszani a dokumentumban mindaddig, amíg az be nem lesz illesztve, például a DOMNode->appendChild() által.

Paraméterek

name

The tag name of the element.

value

The value of the element. By default, an empty element will be created. You can also set the value later with DOMElement->nodeValue.

Visszatérési értékek

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

Kivételek

DOM_INVALID_CHARACTER_ERR

Raised if name contains an invalid character.

Példák

Példa 1. Creating a new element and inserting it as root

<?php

$dom
= new DOMDocument('1.0', 'iso-8859-1');

$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();
?>

A fenti példa a következő kimenetet adja:

<?xml version="1.0" encoding="iso-8859-1"?>
<test>This is the root element!</test>

Lásd még

DOMNode->appendChild()
DOMDocument->createAttribute()
DOMDocument->createAttributeNS()
DOMDocument->createCDATASection()
DOMDocument->createComment()
DOMDocument->createDocumentFragment()
DOMDocument->createElementNS()
DOMDocument->createEntityReference()
DOMDocument->createProcessingInstruction()
DOMDocument->createTextNode()