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
|
<?xml version="1.0" encoding="ISO-8859-1"?>
<!--
-
- This file is part of the OpenLink Software Virtuoso Open-Source (VOS)
- project.
-
- Copyright (C) 1998-2018 OpenLink Software
-
- This project is free software; you can redistribute it and/or modify it
- under the terms of the GNU General Public License as published by the
- Free Software Foundation; only version 2 of the License, dated June 1991.
-
- This program is distributed in the hope that it will be useful, but
- WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
- General Public License for more details.
-
- You should have received a copy of the GNU General Public License along
- with this program; if not, write to the Free Software Foundation, Inc.,
- 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
-
-
-->
<refentry id="fn_XMLATTRIBUTES">
<refmeta>
<refentrytitle>XMLATTRIBUTES</refentrytitle>
<refmiscinfo>xml</refmiscinfo>
</refmeta>
<refnamediv>
<refname>XMLATTRIBUTES</refname>
<refpurpose>Creates a list of attributes and their values</refpurpose>
</refnamediv>
<refsynopsisdiv>
<funcsynopsis id="fsyn_XMLATTRIBUTES">
<funcprototype id="fproto_XMLATTRIBUTES">
<funcdef><function>XMLATTRIBUTES</function></funcdef>
<paramdef><parameter>string_expr1 [AS alias1]</parameter> varchar</paramdef>
<paramdef><optional><parameter>string_expr2 [AS alias2]</parameter> varchar</optional></paramdef>
<paramdef><optional><parameter>...</parameter></optional></paramdef>
<paramdef><optional><parameter>string_exprN [AS aliasN]</parameter> varchar</optional></paramdef>
</funcprototype>
</funcsynopsis>
</refsynopsisdiv>
<refsect1 id="desc_XMLATTRIBUTES"><title>Description</title>
<para>
This function creates a vector that may be used only as argument of
<function>XMLELEMENT</function> function. The vector has an even number of elements, each odd element is a name of an attribute, an
even element is its value. If the attribute value is NULL, then no attribute and no value is created.
If none of the attribute is created, then the function returns NULL.
If string_expr is a column name, then you can omit the AS clause, and Virtuoso uses the partially escaped form of
the column name as the attribute name.
</para>
</refsect1>
<refsect1 id="XMLATTRIBUTES"><title>Parameters</title>
<refsect2><title>String_exprI [AS aliasI]</title>
<para>string value; AS clause is mandatory if it is not a column name but an expression of some other sort.</para>
</refsect2>
</refsect1>
<!--
<refsect1 id="errors_XMLATTRIBUTES">
<title>Errors</title>
<table><title>Errors signalled by <function>XMLATTRIBUTES</function></title>
<tgroup cols="4">
<thead>
<row>
<entry>SQLState</entry><entry>Error Code</entry><entry>Error Text</entry><entry>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry><errorcode>37000</errorcode></entry>
<entry><errorcode>SQ074</errorcode></entry>
<entry><errorname>The special SQL predicate has invalid argument</errorname></entry>
<entry></entry>
</row>
</tbody>
</tgroup>
</table>
<para></para>
</refsect1>
-->
<refsect1 id="XMLATTRIBUTES"><title>Examples</title>
<example id="ex_XMLATTRIBUTES"><title>XMLATTRIBUTES() with two parameters</title>
<para>The following example produces an 'EmpName' elements with two attributes (if value of the column 'Region' is not NULL) or
with one attribute (if value of the column 'Region' is NULL) </para>
<screen>
select XMLELEMENT ("EmpName",
XMLATTRIBUTES ("FirstName" || ' ' || "LastName" as "Name", "Region" ))
from "Demo"."demo"."Employees";
callret
VARCHAR
_______________________________________________________________________________
<EmpName Name="Nancy Davolio" Region="WA" />
<EmpName Name="Andrew Fuller" Region="WA" />
<EmpName Name="Janet Leverling" Region="WA" />
<EmpName Name="Margaret Peacock" Region="WA" />
<EmpName Name="Steven Buchanan" />
<EmpName Name="Michael Suyama" />
<EmpName Name="Robert King" />
<EmpName Name="Laura Callahan" Region="WA" />
<EmpName Name="Anne Dodsworth" />
9 Rows.
</screen>
</example>
</refsect1>
<refsect1 id="seealso_XMLATTRIBUTES"><title>See Also</title>
<para><link linkend="fn_XMLELEMENT">XMLELEMENT()</link></para>
<para><link linkend="fn_XMLFOREST">XMLFOREST()</link></para>
<para><link linkend="fn_XMLAGG">XMLAGG()</link></para>
<para><link linkend="fn_XMLCONCAT">XMLCONCAT()</link></para>
</refsect1>
</refentry>
|
