This file is indexed.

/usr/share/doc/cl-sql/html/sql-operation.html is in cl-sql 6.7.0-1.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="idp73332848"></a><h2>Syntax</h2><pre class="synopsis">
      <code class="function">sql-operation</code> <em class="parameter"><code>operator</code></em> <code class="function">&amp;rest</code> <em class="parameter"><code>args</code></em> =&gt; <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">&amp;rest</code> <em class="parameter"><code>args</code></em> =&gt; <span class="returnvalue">result</span></pre></div><div class="refsect1"><a id="idp73341520"></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="idp74173056"></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="idp74177328"></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 '&gt; (sql-expression :attribute 'bar) 12)
          :order-by (sql-operation 'sum (sql-expression :attribute 'baz)))
=&gt; #&lt;SQL-QUERY SELECT FOO.BAR,SUM(FOO.BAZ) FROM FOO WHERE (BAR &gt; 12) ORDER BY SUM(BAZ)&gt;

(sql-operation 'function "strpos" "CLSQL" "SQL")
=&gt; #&lt;CLSQL-SYS:SQL-FUNCTION-EXP STRPOS('CLSQL','SQL')&gt;
      </pre></div><div class="refsect1"><a id="idp74179312"></a><h2>Side Effects</h2><p>None.</p></div><div class="refsect1"><a id="idp74180464"></a><h2>Affected by</h2><p>
        None.
      </p></div><div class="refsect1"><a id="idp74181616"></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="idp74184384"></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="idp74189136"></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>