From: Tom Lane <tgl@sss.pgh.pa.us>
Date: Sun, 14 Feb 2010 00:48:12 +0000 (+0000)
Subject: Document the behavior of STRICT VARIADIC functions.
X-Git-Tag: REL9_0_ALPHA4~56
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=a9aad1b8687f9919cdf7792c3a04ebc7239fe8f1;p=postgresql

Document the behavior of STRICT VARIADIC functions.
---

diff --git a/doc/src/sgml/ref/create_function.sgml b/doc/src/sgml/ref/create_function.sgml
index 6d7eb84d8f..41dc4365ce 100644
--- a/doc/src/sgml/ref/create_function.sgml
+++ b/doc/src/sgml/ref/create_function.sgml
@@ -1,5 +1,5 @@
 <!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/create_function.sgml,v 1.88 2009/10/08 02:39:14 tgl Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/create_function.sgml,v 1.89 2010/02/14 00:48:12 tgl Exp $
 -->
 
 <refentry id="SQL-CREATEFUNCTION">
@@ -585,6 +585,13 @@ CREATE FUNCTION foo(int, int default 42) ...
     existing calls of the function do not stop working when it is replaced.
    </para>
 
+   <para>
+    If a function is declared <literal>STRICT</> with a <literal>VARIADIC</>
+    argument, the strictness check tests that the variadic array <emphasis>as
+    a whole</> is non-null.  The function will still be called if the
+    array has non-null elements.
+   </para>
+
  </refsect1>
 
  <refsect1 id="sql-createfunction-examples">