database/postgres
1
0
Fork 0
mirror of https://github.com/postgres/postgres.git synced 2025-07-28 23:42:10 +03:00
Code Activity

doc: move ROW IS NULL examples to a different chapter

Browse Source 
Also add examples.

Reported-by: Wolfgang Walther

Discussion: https://postgr.es/m/21ff8e9c-627a-f949-fb00-a41b9ddcc9d3@technowledgy.de

Backpatch-through: master
This commit is contained in:
Bruce Momjian
2023-11-13 15:20:54 -05:00
parent 8680bae846
commit bd86407892
2 changed files with 19 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
doc/src/sgml/func.sgml
View File

@ -718,7 +718,19 @@ repeat('Pg', 4) <returnvalue>PgPgPgPg</returnvalue>
<literal>IS NULL</literal> and <literal>IS NOT NULL</literal> do not always return <literal>IS NULL</literal> and <literal>IS NOT NULL</literal> do not always return
inverse results for row-valued expressions; in particular, a row-valued inverse results for row-valued expressions; in particular, a row-valued
expression that contains both null and non-null fields will return false expression that contains both null and non-null fields will return false
for both tests. In some cases, it may be preferable to for both tests. For example:
<programlisting>
SELECT ROW(1,2.5,'this is a test') = ROW(1, 3, 'not the same');
SELECT ROW(table.*) IS NULL FROM table; -- detect all-null rows
SELECT ROW(table.*) IS NOT NULL FROM table; -- detect all-non-null rows
SELECT NOT(ROW(table.*) IS NOT NULL) FROM TABLE; -- detect at least one null in rows
</programlisting>
In some cases, it may be preferable to
write <replaceable>row</replaceable> <literal>IS DISTINCT FROM NULL</literal> write <replaceable>row</replaceable> <literal>IS DISTINCT FROM NULL</literal>
or <replaceable>row</replaceable> <literal>IS NOT DISTINCT FROM NULL</literal>, or <replaceable>row</replaceable> <literal>IS NOT DISTINCT FROM NULL</literal>,
which will simply check whether the overall row value is null without any which will simply check whether the overall row value is null without any

17
doc/src/sgml/syntax.sgml
View File

@ -2479,17 +2479,12 @@ SELECT getf1(CAST(ROW(11,'this is a test',2.5) AS myrowtype));
<para> <para>
Row constructors can be used to build composite values to be stored Row constructors can be used to build composite values to be stored
in a composite-type table column, or to be passed to a function that in a composite-type table column, or to be passed to a function that
accepts a composite parameter. Also, accepts a composite parameter. Also, it is possible to test rows
it is possible to compare two row values or test a row with using the standard comparison operators as described in <xref
<literal>IS NULL</literal> or <literal>IS NOT NULL</literal>, for example: linkend="functions-comparison"/>, to compare one row against another
<programlisting> as described in <xref linkend="functions-comparisons"/>, and to
SELECT ROW(1,2.5,'this is a test') = ROW(1, 3, 'not the same'); use them in connection with subqueries, as discussed in <xref
linkend="functions-subquery"/>,
SELECT ROW(table.*) IS NULL FROM table; -- detect all-null rows
</programlisting>
For more detail see <xref linkend="functions-comparisons"/>.
Row constructors can also be used in connection with subqueries,
as discussed in <xref linkend="functions-subquery"/>.
</para> </para>
</sect2> </sect2>