-
Notifications
You must be signed in to change notification settings - Fork 70
/
insertbefore.xml
130 lines (128 loc) · 4.44 KB
/
insertbefore.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
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 6f103ee118aacbde15fc894eda6f3ce961548ceb Maintainer: mch Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="domnode.insertbefore" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>DOMNode::insertBefore</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::insertBefore</methodname>
<methodparam><type>DOMNode</type><parameter>node</parameter></methodparam>
<methodparam choice="opt"><type class="union"><type>DOMNode</type><type>null</type></type><parameter>child</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
Данная функция вставляет новый узел перед указанным узлом.
Чтобы вносить изменения в добавленный дочерний узел,
необходимо использовать возвращаемый узел.
</para>
<para>
При использовании существующего узла он будет перемещён.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>node</parameter></term>
<listitem>
<para>
Новый узел.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>child</parameter></term>
<listitem>
<para>
Контрольный узел. Если отсутствует, то <parameter>node</parameter>
добавляется в конец списка потомков.
</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>
<varlistentry>
<term><constant>DOM_NOT_FOUND_ERR</constant></term>
<listitem>
<para>
Возникает, если <parameter>child</parameter> не является дочерним узлом данного узла.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><methodname>DOMNode::appendChild</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
-->