Paul Rogers created IMPALA-7715:
-----------------------------------
Summary: "Impala Conditional Functions" documentation errata
Key: IMPALA-7715
URL: https://issues.apache.org/jira/browse/IMPALA-7715
Project: IMPALA
Issue Type: Improvement
Affects Versions: Impala 3.0
Reporter: Paul Rogers
Consider the documentation page [Impala Conditional
Functions|https://impala.apache.org/docs/build3x/html/topics/impala_conditional_functions.html].
Multiple functions have ambiguous descriptions. For example:
{quote}
isfalse(boolean)
Purpose: Tests if a Boolean expression is false or not. Returns true if so.
{quote}
The above is confusing, it essentially means: "Returns true if a Boolean
expression is false or not." This obviously means the function always returns
false, which is not accurate.
Reword to say: "Returns true if the expression is false. Returns false if the
expression is true or NULL."
Other ambiguous descriptions:
{quote}
istrue(boolean)
Purpose: Tests if a Boolean expression is true or not. Returns true if so.
{quote}
Better: "Returns true if an expression is true. Returns false if the expression
is false or NULL."
Others:
{quote}
nonnullvalue(expression)
Purpose: Tests if an expression (of any type) is NULL or not. Returns false if
so.
{quote}
Better: "Returns true if the expression is non-null, tase if the expression is
null."
{quote}
nullvalue(expression)
Purpose: Tests if an expression (of any type) is NULL or not. Returns true if
so.
{quote}
Better: "Returns true if the expression is NULL, false otherwise."
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
