/usr/share/doc/cl-sql/html/sql-operation.html is in cl-sql 6.5.0-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 | <?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>SQL-OPERATION</title><meta name="generator" content="DocBook XSL Stylesheets V1.78.1" /><link rel="home" href="index.html" title="CLSQL Users' Guide" /><link rel="up" href="ref-syntax.html" title="The Symbolic SQL Syntax" /><link rel="prev" href="sql-expression.html" title="SQL-EXPRESSION" /><link rel="next" href="sql-operator.html" title="SQL-OPERATOR" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">SQL-OPERATION</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="sql-expression.html">Prev</a> </td><th width="60%" align="center">The Symbolic SQL Syntax</th><td width="20%" align="right"> <a accesskey="n" href="sql-operator.html">Next</a></td></tr></table><hr /></div><div class="refentry"><a id="sql-operation"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>SQL-OPERATION — Constructs an SQL expression from a supplied operator and arguments.<strong>Function</strong></p></div><div class="refsect1"><a id="idp61065248"></a><h2>Syntax</h2><pre class="synopsis">
<code class="function">sql-operation</code> <em class="parameter"><code>operator</code></em> <code class="function">&rest</code> <em class="parameter"><code>args</code></em> => <span class="returnvalue">result</span></pre><pre class="synopsis">
<code class="function">sql-operation</code> 'function <em class="parameter"><code>func</code></em> <code class="function">&rest</code> <em class="parameter"><code>args</code></em> => <span class="returnvalue">result</span></pre></div><div class="refsect1"><a id="idp61073920"></a><h2>Arguments and Values</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term"><em class="parameter"><code>operator</code></em></span></dt><dd><p>A symbol denoting an SQL operator.</p></dd><dt><span class="term"><em class="parameter"><code>func</code></em></span></dt><dd><p>A string denoting an SQL function.</p></dd><dt><span class="term"><em class="parameter"><code>args</code></em></span></dt><dd><p>A set of arguments for the specified SQL operator or function.</p></dd><dt><span class="term"><span class="returnvalue">result</span></span></dt><dd><p>A object of type <code class="function">sql-expression</code>.</p></dd></dl></div></div><div class="refsect1"><a id="idp61084560"></a><h2>Description</h2><p>Returns an SQL expression constructed from the supplied
SQL operator or function <em class="parameter"><code>operator</code></em> and
its arguments <em class="parameter"><code>args</code></em>. If
<em class="parameter"><code>operator</code></em> is passed the symbol 'function
then the first value in <em class="parameter"><code>args</code></em> is taken to
be a valid SQL function and the remaining values in
<em class="parameter"><code>args</code></em> its arguments.
</p></div><div class="refsect1"><a id="idp61089504"></a><h2>Examples</h2><pre class="screen">
(sql-operation 'select
(sql-expression :table 'foo :attribute 'bar)
(sql-operation 'sum (sql-expression :table 'foo :attribute 'baz))
:from
(sql-expression :table 'foo)
:where
(sql-operation '> (sql-expression :attribute 'bar) 12)
:order-by (sql-operation 'sum (sql-expression :attribute 'baz)))
=> #<SQL-QUERY SELECT FOO.BAR,SUM(FOO.BAZ) FROM FOO WHERE (BAR > 12) ORDER BY SUM(BAZ)>
(sql-operation 'function "strpos" "CLSQL" "SQL")
=> #<CLSQL-SYS:SQL-FUNCTION-EXP STRPOS('CLSQL','SQL')>
</pre></div><div class="refsect1"><a id="idp61970032"></a><h2>Side Effects</h2><p>None.</p></div><div class="refsect1"><a id="idp61971184"></a><h2>Affected by</h2><p>
None.
</p></div><div class="refsect1"><a id="idp61972336"></a><h2>Exceptional Situations</h2><p>An error of type <a class="link" href="sql-user-error.html" title="SQL-USER-ERROR"><code class="function">sql-user-error</code></a>
is signalled if <em class="parameter"><code>operator</code></em> is not a symbol
representing a supported SQL operator.</p></div><div class="refsect1"><a id="idp61975104"></a><h2>See Also</h2><table border="0" summary="Simple list" class="simplelist"><tr><td><a class="link" href="sql.html" title="SQL"><code class="function">sql</code></a></td></tr><tr><td><a class="link" href="sql-expression.html" title="SQL-EXPRESSION"><code class="function">sql-expression</code></a></td></tr><tr><td><a class="link" href="sql-operator.html" title="SQL-OPERATOR"><code class="function">sql-operator</code></a></td></tr></table></div><div class="refsect1"><a id="idp61979856"></a><h2>Notes</h2><p>None.</p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="sql-expression.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ref-syntax.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="sql-operator.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">SQL-EXPRESSION </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> SQL-OPERATOR</td></tr></table></div></body></html>
|