[jira] [Created] (IMPALA-7715) "Impala Conditional Functions" documentation errata

["Paul Rogers (JIRA)" <ji...@apache.org>]

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: issues-all-unsubscribe@impala.apache.org
For additional commands, e-mail: issues-all-help@impala.apache.org