XMLWriter::writeElement

xmlwriter_write_element

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

XMLWriter::writeElement -- xmlwriter_write_element — 要素タグ全体を書き込む

説明

オブジェクト指向型

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

手続き型

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

要素タグ全体を書き込みます。

パラメータ

xmlwriter: 手続き型のコールでのみ使用します。変更される XMLWriter resource です。このリソースは、xmlwriter_open_uri() あるいは xmlwriter_open_memory() のコールによって取得したものです。
name: 要素名。
content: 要素の内容。

返り値

成功した場合に TRUE を、失敗した場合に FALSE を返します。

変更履歴

バージョン	説明
PHP 5.2.3	`content` パラメータがオプションとなりました。

参考

XMLWriter::startElement() - 要素の開始タグを作成する
XMLWriter::endElement() - 現在の要素を終了する
XMLWriter::writeElementNS() - 名前空間つき要素タグ全体を書き込む

add a note User Contributed Notes XMLWriter::writeElement

rjb at robertjbrown dot com 25-Jan-2010 03:04


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".

googolplex at gmx dot net 09-Dec-2008 03:08


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