-
Notifications
You must be signed in to change notification settings - Fork 70
/
appendchild.xml
159 lines (152 loc) · 4.98 KB
/
appendchild.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bc83b0a2f223a5ca9daaf22bd82215791bccde31 Maintainer: das Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="domnode.appendchild" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>DOMNode::appendChild</refname>
<refpurpose>
Добавляет новый дочерний узел в конец списка потомков
</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis role="DOMNode">
<modifier>public</modifier> <type class="union"><type>DOMNode</type><type>false</type></type><methodname>DOMNode::appendChild</methodname>
<methodparam><type>DOMNode</type><parameter>node</parameter></methodparam>
</methodsynopsis>
<para>
Функция добавляет дочерний узел в существующий
список потомков или создаёт новый список дочерних элементов.
Дочерний узел может быть создан с помощью
<methodname>DOMDocument::createElement</methodname>,
<methodname>DOMDocument::createTextNode</methodname> и т.д.,
или может быть использован любой другой узел.
</para>
<para>
При использовании существующего узла он будет перемещён.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>node</parameter></term>
<listitem>
<para>
Добавляемый дочерний узел.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Возвращает добавленный узел или &false; в случае возникновения ошибки.
</para>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
<para>
<variablelist>
<varlistentry>
<term><constant>DOM_NO_MODIFICATION_ALLOWED_ERR</constant></term>
<listitem>
<para>
Возникает, если узел доступен только для чтения или
предыдущий родитель вставляемого узла доступен только для чтения.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>DOM_HIERARCHY_REQUEST_ERR</constant></term>
<listitem>
<para>
Возникает, если тип узла не поддерживает потомков типа,
который имеет узел <parameter>node</parameter>,
или если добавляемый узел является одним из предком целевого узла или им самим.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>DOM_WRONG_DOCUMENT_ERR</constant></term>
<listitem>
<para>
Возникает, если <parameter>node</parameter> создан в другом документе,
отличном от того, в котором был создан этот узел.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
Следующий пример добавляет новый узел в только что созданный документ.
<example>
<title>Добавление дочернего узла</title>
<programlisting role="php">
<![CDATA[
<?php
$doc = new DOMDocument;
$node = $doc->createElement("para");
$newnode = $doc->appendChild($node);
echo $doc->saveXML();
?>
]]>
</programlisting>
</example>
</para>
<para>
<example>
<title>Вложенные дочерние узлы</title>
<programlisting role="php">
<![CDATA[
<?php
$doc = new DOMDocument;
$headNode = $doc->createElement("head");
$doc->appendChild($headNode);
$titleNode = $doc->createElement("title");
$headNode->appendChild($titleNode);
echo $doc->saveXML();
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><methodname>DOMChildNode::after</methodname></member>
<member><methodname>DOMNode::insertBefore</methodname></member>
<member><methodname>DOMNode::removeChild</methodname></member>
<member><methodname>DOMNode::replaceChild</methodname></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
-->