-
Notifications
You must be signed in to change notification settings - Fork 56
/
appendchild.xml
163 lines (153 loc) · 4.48 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
160
161
162
163
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bc83b0a2f223a5ca9daaf22bd82215791bccde31 Maintainer: takagi Status: ready -->
<!-- Credits: mumumu -->
<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
-->