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

Previously the combination of "does not return" and "any row" caused
ambiguity.

Reported-by: KES <kes-kes@yandex.ru>

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

Reviewed-by: David G. Johnston

Backpatch-through: 9.3
This commit is contained in:
Bruce Momjian 2018-11-02 08:54:34 -04:00
parent 87f76f1324
commit f5382cfc70

View File

@ -14620,7 +14620,7 @@ WHERE EXISTS (SELECT 1 FROM tab2 WHERE col2 = tab1.col2);
The result is <quote>false</> if the comparison returns false for every The result is <quote>false</> 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>
@ -14646,7 +14646,7 @@ WHERE EXISTS (SELECT 1 FROM tab2 WHERE col2 = tab1.col2);
The result of <token>ALL</token> is <quote>true</> if all rows yield true The result of <token>ALL</token> is <quote>true</> 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</> if any false result is found. The result is <quote>false</> 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>
@ -14676,8 +14676,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</> if the comparison returns false for any The result is <quote>false</> 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>