XMLWriter::writeElement

xmlwriter_write_element

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

XMLWriter::writeElement -- xmlwriter_write_elementWrite full element tag

Description

Object oriented style

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

Procedural style

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

Writes a full element tag.

Parameters

xmlwriter

Only for procedural calls. The XMLWriter resource that is being modified. This resource comes from a call to xmlwriter_open_uri() or xmlwriter_open_memory().

name

The element name.

content

The element contents.

Return Values

Returns TRUE on success or FALSE on failure.

Changelog

Version Description
5.2.3 The content parameter became optional.

See Also

Коментарии

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>

?>
2008-12-09 08:08:23
http://php5.kiev.ua/manual/ru/function.xmlwriter-write-element.html
Please note that XMLWriter::writeElement will automatically sanitize the content passed as second parameter, so & becomes &amp;, < becomes &lt; and so on.

If you want to input markup directly into an element without validating it, you should use XMLWriter::writeRaw, which writes the contents as is, without any sanitizing.
2017-03-23 14:01:10
http://php5.kiev.ua/manual/ru/function.xmlwriter-write-element.html
Note that if you write element names with spaces or another characters not permitted for W3C Recommendation (https://www.w3.org/TR/xml/#NT-NameStartChar) this method will throw: PHP Warning:  XMLWriter::writeElement(): Invalid Element Name
2020-07-27 22:06:18
http://php5.kiev.ua/manual/ru/function.xmlwriter-write-element.html

    Поддержать сайт на родительском проекте КГБ