~ubuntu-branches/ubuntu/raring/scilab/raring-proposed

« back to all changes in this revision

Viewing changes to modules/xml/help/ja_JP/XMLObjects.xml

  • Committer: Package Import Robot
  • Author(s): Sylvestre Ledru
  • Date: 2012-08-30 14:42:38 UTC
  • mfrom: (1.4.7)
  • Revision ID: package-import@ubuntu.com-20120830144238-c1y2og7dbm7m9nig
Tags: 5.4.0-beta-3-1~exp1
* New upstream release
* Update the scirenderer dep
* Get ride of libjhdf5-java dependency

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<?xml version="1.0" encoding="UTF-8"?>
 
2
<!--
 
3
* Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
 
4
* Copyright (C) 2012 - Scilab Enterprises - Calixte DENIZET
 
5
*
 
6
* This file must be used under the terms of the CeCILL.
 
7
* This source file is licensed as described in the file COPYING, which
 
8
* you should have received as part of this distribution.  The terms
 
9
* are also available at
 
10
* http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt
 
11
*
 
12
-->
 
13
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" version="5.0-subset Scilab" xml:id="XMLObjects" xml:lang="ja">
 
14
    <refnamediv>
 
15
        <refname>XML Objects</refname>
 
16
        <refpurpose>異なるのXMLオブジェクトのプロパティを記述する</refpurpose>
 
17
    </refnamediv>
 
18
    <refsection>
 
19
        <title>内容</title>
 
20
        <itemizedlist>
 
21
            <listitem>
 
22
                <para>
 
23
                    <link linkend="XMLDocument">XML文書</link>
 
24
                </para>
 
25
            </listitem>
 
26
            <listitem>
 
27
                <para>
 
28
                    <link linkend="XMLElement">XML要素</link>
 
29
                </para>
 
30
            </listitem>
 
31
            <listitem>
 
32
                <para>
 
33
                    <link linkend="XMLAttributes">XML属性</link>
 
34
                </para>
 
35
            </listitem>
 
36
            <listitem>
 
37
                <para>
 
38
                    <link linkend="XMLNamespace">XML名前空間</link>
 
39
                </para>
 
40
            </listitem>
 
41
            <listitem>
 
42
                <para>
 
43
                    <link linkend="XMLNodeList">XMLノードリスト</link>
 
44
                </para>
 
45
            </listitem>
 
46
            <listitem>
 
47
                <para>
 
48
                    <link linkend="XMLNodeSet">XML XPath結果セット</link>
 
49
                </para>
 
50
            </listitem>
 
51
            <listitem>
 
52
                <para>
 
53
                    <link linkend="XMLValid">XML検証ファイル</link>
 
54
                </para>
 
55
            </listitem>
 
56
        </itemizedlist>
 
57
    </refsection>
 
58
    <refsection>
 
59
        <title>説明</title>
 
60
        <para>ノードおよびそのプロパティをアクセスおよび修正可能です.</para>
 
61
    </refsection>
 
62
    <refsection id="XMLDocument">
 
63
        <title>XML文書</title>
 
64
        <para>XML文書は以下の2つのプロパティを有します: root および url
 
65
            <itemizedlist>
 
66
                <listitem>
 
67
                    <para>
 
68
                        <emphasis role="bold">root</emphasis>: 文書のルート要素で, XML要素です;
 
69
                    </para>
 
70
                </listitem>
 
71
                <listitem>
 
72
                    <para>
 
73
                        <emphasis role="bold">url</emphasis>: urlは文字列で,
 
74
                        存在する場合は文書のURL,未定義の場合は空文字列となります.
 
75
                    </para>
 
76
                </listitem>
 
77
            </itemizedlist>
 
78
        </para>
 
79
        <programlisting role="example"><![CDATA[
 
80
    doc = xmlReadStr("<root><a att=""foo"" rib=""bar""><b>Hello</b></a></root>");
 
81
    doc.root = doc.root.children(1);
 
82
    xmlDump(doc)
 
83
    doc.url = TMPDIR+"/foo.xml";
 
84
    doc
 
85
    xmlWrite(doc);
 
86
    xmlDelete(doc);
 
87
    ]]></programlisting>
 
88
    </refsection>
 
89
    <refsection id="XMLElement">
 
90
        <title>XML要素</title>
 
91
        <para>XML要素は以下の7つのプロパティを有します:
 
92
            <itemizedlist>
 
93
                <listitem>
 
94
                    <para>
 
95
                        <emphasis role="bold">name</emphasis>: タグ名;
 
96
                    </para>
 
97
                </listitem>
 
98
                <listitem>
 
99
                    <para>
 
100
                        <emphasis role="bold">namespace</emphasis>: XML名前空間オブジェクト;
 
101
                    </para>
 
102
                </listitem>
 
103
                <listitem>
 
104
                    <para>
 
105
                        <emphasis role="bold">content</emphasis>: 
 
106
                        ノードの内容を表す文字列.
 
107
                        例えば,&lt;A&gt;hello &lt;B&gt;world&lt;/B&gt; というノードA
 
108
                        の内容は文字列 "hello world"となります.
 
109
                    </para>
 
110
                </listitem>
 
111
                <listitem>
 
112
                    <para>
 
113
                        <emphasis role="bold">type</emphasis>: 
 
114
                        ノードの型を表す文字列. 以下の値のどれかとなります:
 
115
                        "XML_ELEMENT_NODE", "XML_ATTRIBUTE_NODE", "XML_TEXT_NODE", "XML_CDATA_SECTION_NODE", "XML_ENTITY_REF_NODE", "XML_ENTITY_NODE", "XML_PI_NODE", "XML_COMMENT_NODE", "XML_DOCUMENT_NODE", "XML_DOCUMENT_TYPE_NODE", "XML_DOCUMENT_FRAG_NODE", "XML_NOTATION_NODE", "XML_HTML_DOCUMENT_NODE", "XML_DTD_NODE", "XML_ELEMENT_DECL", "XML_ATTRIBUTE_DECL", "XML_ENTITY_DECL", "XML_NAMESPACE_DECL", "XML_XINCLUDE_START", "XML_XINCLUDE_END", "XML_DOCB_DOCUMENT_NODE".
 
116
                    </para>
 
117
                </listitem>
 
118
                <listitem>
 
119
                    <para>
 
120
                        <emphasis role="bold">parent</emphasis>: 親XML要素;
 
121
                    </para>
 
122
                </listitem>
 
123
                <listitem>
 
124
                    <para>
 
125
                        <emphasis role="bold">attributes</emphasis>: 
 
126
                        XML属性オブジェクトとして表したノード属性;
 
127
                    </para>
 
128
                </listitem>
 
129
                <listitem>
 
130
                    <para>
 
131
                        <emphasis role="bold">children</emphasis>: 
 
132
                        XMLノードリストオブジェクトとして表した子要素.
 
133
                    </para>
 
134
                </listitem>
 
135
                <listitem>
 
136
                    <para>
 
137
                        <emphasis role="bold">line</emphasis>: 
 
138
                        XML要素の線の定義.
 
139
                    </para>
 
140
                </listitem>
 
141
            </itemizedlist>
 
142
            <programlisting role="example"><![CDATA[
 
143
    doc = xmlReadStr("<root xmlns:bar=""http://www.scilab.org/""><bar:a att=""foo"" rib=""bar""><b>Hello</b><c> world</c></bar:a></root>");
 
144
    first = doc.root.children(1);
 
145
    b = first.children(1);
 
146
 
 
147
    // "new_attribute"という名前の属性を新規に追加
 
148
    first.attributes.new_attribute = "value";
 
149
 
 
150
    // firstの子の名前空間を表示
 
151
    first.namespace
 
152
 
 
153
    // ノードの内容を表示
 
154
    first.content
 
155
 
 
156
    // bは親を有します
 
157
    b.parent
 
158
 
 
159
    // firstに子を追加できます.
 
160
    first.children(3) = b
 
161
 
 
162
    // 整数でない添字により挿入を行えます.
 
163
    first.children(1.5) = "<d> Scilab</d>"
 
164
 
 
165
    // firstの子が上の行で定義されています...
 
166
    b.line
 
167
 
 
168
    xmlDump(first)
 
169
    xmlDelete(doc);
 
170
    ]]></programlisting>
 
171
        </para>
 
172
    </refsection>
 
173
    <refsection id="XMLAttributes">
 
174
        <title>XML属性</title>
 
175
        <para>
 
176
            XML属性は,属性の名前を属性の値にマップするハッシュテーブルの一種です.
 
177
            属性の値は,このオブジェクトのフィールドとして属性の名前,または
 
178
            1から属性の大きさまでの添字番号によりアクセスや修正が可能です.
 
179
        </para>
 
180
        <programlisting role="example"><![CDATA[
 
181
    doc = xmlReadStr("<root xmlns:bar=""http://www.scilab.org/""><bar:a att=""foo"" rib=""bar""><b>Hello</b><c> world</c></bar:a></root>");
 
182
    first = doc.root.children(1);
 
183
 
 
184
    // 属性を読み込みます
 
185
    first.attributes.att
 
186
 
 
187
    // 空の属性を設定します
 
188
    first.attributes.att = "";
 
189
 
 
190
    // 新しい属性を追加します
 
191
    first.attributes.hello = "world";
 
192
 
 
193
    // 添字を使用します
 
194
    first.attributes(1) = "Bonjour";
 
195
    first.attributes(1)
 
196
 
 
197
    xmlDump(first)
 
198
    xmlDelete(doc);
 
199
    ]]></programlisting>
 
200
    </refsection>
 
201
    <refsection id="XMLNamespace">
 
202
        <title>XML名前空間</title>
 
203
        <para>XML名前空間は以下の2つのプロパティを有します: href および prefix
 
204
            <itemizedlist>
 
205
                <listitem>
 
206
                    <para>
 
207
                        <emphasis role="bold">href</emphasis>: 名前空間hrefを表す文字列;
 
208
                    </para>
 
209
                </listitem>
 
210
                <listitem>
 
211
                    <para>
 
212
                        <emphasis role="bold">prefix</emphasis>: 
 
213
                        この名前空間で使用する接頭辞を表す文字列.
 
214
                    </para>
 
215
                </listitem>
 
216
            </itemizedlist>
 
217
        </para>
 
218
        <programlisting role="example"><![CDATA[
 
219
    doc = xmlReadStr("<root xmlns:bar=""http://www.scilab.org/""><bar:a att=""foo"" rib=""bar""><b>Hello</b><c> world</c></bar:a></root>");
 
220
    ns = doc.root.children(1).namespace;
 
221
    ns.href
 
222
    ns.prefix
 
223
 
 
224
    xmlDelete(doc);
 
225
    ]]></programlisting>
 
226
    </refsection>
 
227
    <refsection id="XMLNodeList">
 
228
        <title>XMLノードリスト</title>
 
229
        <para>
 
230
            XMLノードリストはある要素の子に番号を付ける際に使用される
 
231
            型です.各要素は整数の添字によりアクセスできます.
 
232
            これはリストであるため,doubleの添字により,
 
233
            新しい要素をこのリストに挿入することができます.
 
234
        </para>
 
235
        <para>
 
236
            リストの大きさは,'size'フィールドにより取得できます.
 
237
        </para>
 
238
        <para>
 
239
            リストの各ノードの名前または内容は'name'または'content'フィールド
 
240
            により取得できます.
 
241
        </para>
 
242
        <programlisting role="example"><![CDATA[
 
243
    doc = xmlReadStr("<root><a>Hello</a><b> world</b></root>");
 
244
    c = doc.root.children;
 
245
 
 
246
    // 2つの要素があることが確認できます
 
247
    c.size
 
248
 
 
249
    // 最初の要素を読み込みます
 
250
    xmlDump(c(1))
 
251
 
 
252
    // 特定の要素を他の要素で置換します
 
253
    c(1) = "<c>Hello</c>"
 
254
 
 
255
    // 新しい要素を最初の要素と二番目の要素の間に挿入します
 
256
    c(1.5) = "<d> Scilab</d>" // 1.5 or 1.234...
 
257
 
 
258
    // 新しい要素を末尾またはリストの先頭に挿入します
 
259
    c(0) = "<e>Head </e>"
 
260
    c(217) = "<f> Tail</f>"
 
261
 
 
262
    xmlDump(c)
 
263
 
 
264
    // ノードの名前を取得します
 
265
    c.name
 
266
 
 
267
    // ノードの内容を取得します
 
268
    c.content
 
269
 
 
270
    xmlDelete(doc);
 
271
    ]]></programlisting>
 
272
    </refsection>
 
273
    <refsection id="XMLNodeSet">
 
274
        <title>XML XPath結果セット</title>
 
275
        <para>
 
276
            XMLノードセットは,XPathクエリから返されたオブジェクトです.
 
277
            新しい要素を挿入したり,既存の要素を置換することはできません.
 
278
            できることは整数の添字により要素を取得することのみです.
 
279
        </para>
 
280
        <para>
 
281
            このセットの大きさは'size'フィールドにより取得できます.
 
282
        </para>
 
283
        <programlisting role="example"><![CDATA[
 
284
    doc = xmlReadStr("<root><a><b>Hello</b></a><a>World</a></root>");
 
285
    s = xmlXPath(doc, "//a")
 
286
    s.size
 
287
 
 
288
    s(1).content
 
289
    s(2).content
 
290
 
 
291
    // または ...
 
292
    s.content
 
293
 
 
294
    xmlDelete(doc);
 
295
    ]]></programlisting>
 
296
    </refsection>
 
297
    <refsection id="XMLValid">
 
298
        <title>XML検証ファイル</title>
 
299
        <para>XML検証ファイルは文書の検証に使用されるオブジェクトです.
 
300
            DTD, Relax NGまたは schemaにより検証できます.
 
301
        </para>
 
302
        <programlisting role="example"><![CDATA[
 
303
    doc = xmlRead("SCI/modules/xml/tests/unit_tests/library.xml");
 
304
    dtd = xmlDTD("SCI/modules/xml/tests/unit_tests/library.dtd");
 
305
    schema = xmlSchema("SCI/modules/xml/tests/unit_tests/library.xsd");
 
306
    rng = xmlRelaxNG("SCI/modules/xml/tests/unit_tests/library.rng");
 
307
 
 
308
    // 検証
 
309
    xmlValidate(doc, dtd);
 
310
    xmlValidate(doc, rng);
 
311
    xmlValidate(doc, schema);
 
312
 
 
313
    xmlDelete("all");
 
314
    ]]></programlisting>
 
315
    </refsection>
 
316
    <refsection role="see also">
 
317
        <title>参照</title>
 
318
        <simplelist type="inline">
 
319
            <member>
 
320
                <link linkend="xmlRead">xmlRead</link>
 
321
            </member>
 
322
            <member>
 
323
                <link linkend="xmlReadStr">xmlReadStr</link>
 
324
            </member>
 
325
            <member>
 
326
                <link linkend="xmlElement">xmlElement</link>
 
327
            </member>
 
328
            <member>
 
329
                <link linkend="xmlDocument">xmlDocument</link>
 
330
            </member>
 
331
            <member>
 
332
                <link linkend="xmlNs">xmlNs</link>
 
333
            </member>
 
334
            <member>
 
335
                <link linkend="xmlDTD">xmlDTD</link>
 
336
            </member>
 
337
            <member>
 
338
                <link linkend="xmlSchema">xmlSchema</link>
 
339
            </member>
 
340
            <member>
 
341
                <link linkend="xmlRelaxNG">xmlRelaxNG</link>
 
342
            </member>
 
343
        </simplelist>
 
344
    </refsection>
 
345
    <refsection>
 
346
        <title>履歴</title>
 
347
        <revhistory>
 
348
            <revision>
 
349
                <revnumber>5.4.0</revnumber>
 
350
                <revremark>XMLモジュールが導入されました.</revremark>
 
351
            </revision>
 
352
        </revhistory>
 
353
    </refsection>
 
354
</refentry>