Files
php-doc-ru/reference/simplexml/simplexmlelement/asXML.xml
sergey 63da451bcf upd: actual en-revision
git-svn-id: https://svn.php.net/repository/phpdoc/ru/trunk@347581 c90b9560-bf6c-de11-be94-00142212c4b1
2019-06-08 21:55:31 +00:00

155 lines
3.7 KiB
XML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 37909220d257288cef2969d3e825394d62b5830d Maintainer: mch Status: ready -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="simplexmlelement.asxml" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>SimpleXMLElement::asXML</refname>
<refpurpose>
Возвращает сформированный XML-документ в виде строки на основе элемента SimpleXML
</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier> <type>mixed</type><methodname>SimpleXMLElement::asXML</methodname>
<methodparam choice="opt"><type>string</type><parameter>filename</parameter></methodparam>
</methodsynopsis>
<para>
Метод <literal>asXML</literal> задает формат данных родительских объектов
в версии XML 1.0.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>filename</parameter></term>
<listitem>
<para>
Если указан, то функция запишет данные в файл,
а не вернет их.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Если <parameter>filename</parameter> не указан, то функция
вернет строку (<type>string</type>) в случае успеха и &false; в случае ошибки. Если
параметр указан, то функция вернет &true;, если файл будет успешно записан и
&false; в противном случае.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Получение XML</title>
<programlisting role="php">
<![CDATA[
<?php
$string = <<<XML
<a>
<b>
<c>текст</c>
<c>штучка</c>
</b>
<d>
<c>код</c>
</d>
</a>
XML;
$xml = new SimpleXMLElement($string);
echo $xml->asXML();
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
<?xml version="1.0"?>
<a>
<b>
<c>текст</c>
<c>штучка</c>
</b>
<d>
<c>код</c>
</d>
</a>
]]>
</screen>
</example>
</para>
<para>
<literal>asXML</literal> также работает с результатами Xpath:
<example>
<title>Использование asXML() с результатами <methodname>SimpleXMLElement::xpath</methodname></title>
<programlisting role="php">
<![CDATA[
<?php
// Продолжение примера XML выше.
/* Поиск <a><b><c> */
$result = $xml->xpath('/a/b/c');
foreach ($result as $node) {
echo $node->asXML();
}
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
<c>текст</c><c>штучка</c>
]]>
</screen>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><methodname>SimpleXMLElement::__toString</methodname></member>
<member><xref linkend="simplexml.examples-basic"/></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->