org.apache.calcite.plan

Enum RelOptUtil.Logic

java.lang.Object

java.lang.Enum<RelOptUtil.Logic>

org.apache.calcite.plan.RelOptUtil.Logic

All Implemented Interfaces:

Serializable, Comparable<RelOptUtil.Logic>

Enclosing class:

RelOptUtil

public static enum RelOptUtil.Logic
extends Enum<RelOptUtil.Logic>

Policies for handling two- and three-valued boolean logic.

Enum Constant Summary

Enum Constants

Enum Constant and Description
FALSE An anti-semi-join will have been applied, so that only rows for which the value is FALSE will have been returned.
TRUE A semi-join will have been applied, so that only rows for which the value is TRUE will have been returned.
TRUE_FALSE Nulls are not possible.
TRUE_FALSE_UNKNOWN Three-valued boolean logic.
UNKNOWN_AS_FALSE Two-valued logic where UNKNOWN is treated as FALSE.
UNKNOWN_AS_TRUE Two-valued logic where UNKNOWN is treated as TRUE.

Method Summary

Modifier and Type	Method and Description
RelOptUtil.Logic	negate()
RelOptUtil.Logic	negate2() Variant of negate() to be used within LogicVisitor, where FALSE values may exist.
static RelOptUtil.Logic	valueOf(String name) Returns the enum constant of this type with the specified name.
static RelOptUtil.Logic[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

TRUE_FALSE_UNKNOWN

public static final RelOptUtil.Logic TRUE_FALSE_UNKNOWN

Three-valued boolean logic.

TRUE_FALSE

public static final RelOptUtil.Logic TRUE_FALSE

Nulls are not possible.

UNKNOWN_AS_FALSE

public static final RelOptUtil.Logic UNKNOWN_AS_FALSE

Two-valued logic where UNKNOWN is treated as FALSE.

"x IS TRUE" produces the same result, and "WHERE x", "JOIN ... ON x" and "HAVING x" have the same effect.

UNKNOWN_AS_TRUE

public static final RelOptUtil.Logic UNKNOWN_AS_TRUE

Two-valued logic where UNKNOWN is treated as TRUE.

"x IS FALSE" produces the same result, as does "WHERE NOT x", etc.

In particular, this is the mode used by "WHERE k NOT IN q". If "k IN q" produces TRUE or UNKNOWN, "NOT k IN q" produces FALSE or UNKNOWN and the row is eliminated; if "k IN q" it returns FALSE, the row is retained by the WHERE clause.

TRUE

public static final RelOptUtil.Logic TRUE

A semi-join will have been applied, so that only rows for which the value is TRUE will have been returned.

FALSE

public static final RelOptUtil.Logic FALSE

An anti-semi-join will have been applied, so that only rows for which the value is FALSE will have been returned.

Currently only used within LogicVisitor, to ensure that 'NOT (NOT EXISTS (q))' behaves the same as 'EXISTS (q)')

Method Detail

values

public static RelOptUtil.Logic[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (RelOptUtil.Logic c : RelOptUtil.Logic.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static RelOptUtil.Logic valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null

negate

public RelOptUtil.Logic negate()

negate2

public RelOptUtil.Logic negate2()

Variant of negate() to be used within LogicVisitor, where FALSE values may exist.