XMLWriter::writeElement

xmlwriter_write_element

(PHP 5 >= 5.1.2, PECL xmlwriter >= 0.1.0)

XMLWriter::writeElement -- xmlwriter_write_element — Write full element tag

설명

객체 기반 형식

bool XMLWriter::writeElement ( string $name [, string $content ] )

절차식 형식

bool xmlwriter_write_element ( resource $xmlwriter , string $name [, string $content ] )

Writes a full element tag.

인수

xmlwriter: 순차적 호출에서만 사용. XMLWriter resource가 수정됩니다. 이 자원은 xmlwriter_open_uri()나 xmlwriter_open_memory() 호출로 만들어집니다.
name: The element name.
content: The element contents.

반환값

성공할 경우 TRUE를, 실패할 경우 FALSE를 반환합니다.

변경점

버전	설명
PHP 5.2.3	The `content` parameter became optional.

참고

XMLWriter::startElement() - Create start element tag
XMLWriter::endElement() - End current element
XMLWriter::writeElementNS() - Write full namespaced element tag

add a note User Contributed Notes XMLWriter::writeElement - [2 notes]

down

rjb at robertjbrown dot com ¶

3 years ago


Quick note - writeElement also seems to decode any HTML entities during the write. For example, if you pass it "Me & You", it will write the output as "Me &amp; You".

down

googolplex at gmx dot net ¶

4 years ago


The function XMLWriter::writeElement is used to write an element (i.e. a XML tag, an [optional] content, and a closing XML tag) in one line without sub-elements:



<?php



$oXMLout = new XMLWriter();

$oXMLout->openMemory();

$oXMLout->writeElement("quantity", 8);

$oXMLout->writeElement("price_per_quantity", 110);

print $oXMLout->outputMemory();



// produces:

// <quantity>8</quantity>

// <price_per_quantity>110</price_per_quantity>



?>



whereas if you want to include sub-elements you have to use the XMLWriter::startElement / XMLWriter::endElement pair:



<?php



$oXMLout = new XMLWriter();

$oXMLout->openMemory();

$oXMLout->startElement("item");

$oXMLout->writeElement("quantity", 8);

$oXMLout->writeElement("price_per_quantity", 110);

$oXMLout->endElement();

print $oXMLout->outputMemory();



// produces:

// <item>

// <quantity>8</quantity>

// <price_per_quantity>110</price_per_quantity>

// </item>



?>

add a note