Commit 8610c973 authored by Bruce Momjian's avatar Bruce Momjian

doc: use simpler language for NULL return from ANY/ALL

Previously the combination of "does not return" and "any row" caused
ambiguity.
Reported-by: default avatarKES <kes-kes@yandex.ru>

Discussion: https://postgr.es/m/153701242703.22334.1476830122267077397@wrigleys.postgresql.org

Reviewed-by: David G. Johnston

Backpatch-through: 9.3
parent 6286efb5
...@@ -15246,7 +15246,7 @@ WHERE EXISTS (SELECT 1 FROM tab2 WHERE col2 = tab1.col2); ...@@ -15246,7 +15246,7 @@ WHERE EXISTS (SELECT 1 FROM tab2 WHERE col2 = tab1.col2);
The result is <quote>false</quote> if the comparison returns false for every The result is <quote>false</quote> if the comparison returns false for every
subquery row (including the case where the subquery returns no subquery row (including the case where the subquery returns no
rows). rows).
The result is NULL if the comparison does not return true for any row, The result is NULL if no comparison with a subquery row returns true,
and it returns NULL for at least one row. and it returns NULL for at least one row.
</para> </para>
...@@ -15272,7 +15272,7 @@ WHERE EXISTS (SELECT 1 FROM tab2 WHERE col2 = tab1.col2); ...@@ -15272,7 +15272,7 @@ WHERE EXISTS (SELECT 1 FROM tab2 WHERE col2 = tab1.col2);
The result of <token>ALL</token> is <quote>true</quote> if all rows yield true The result of <token>ALL</token> is <quote>true</quote> if all rows yield true
(including the case where the subquery returns no rows). (including the case where the subquery returns no rows).
The result is <quote>false</quote> if any false result is found. The result is <quote>false</quote> if any false result is found.
The result is NULL if the comparison does not return false for any row, The result is NULL if no comparison with a subquery row returns false,
and it returns NULL for at least one row. and it returns NULL for at least one row.
</para> </para>
...@@ -15302,8 +15302,8 @@ WHERE EXISTS (SELECT 1 FROM tab2 WHERE col2 = tab1.col2); ...@@ -15302,8 +15302,8 @@ WHERE EXISTS (SELECT 1 FROM tab2 WHERE col2 = tab1.col2);
case where the subquery returns no rows). case where the subquery returns no rows).
The result is <quote>false</quote> if the comparison returns false for any The result is <quote>false</quote> if the comparison returns false for any
subquery row. subquery row.
The result is NULL if the comparison does not return false for any The result is NULL if no comparison with a subquery row returns false,
subquery row, and it returns NULL for at least one row. and it returns NULL for at least one row.
</para> </para>
<para> <para>
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment