An expression node for CASE WHEN clauses. More...

#include <qgsexpressionnodeimpl.h>

Inheritance diagram for QgsExpressionNodeCondition:

Classes
class	WhenThen
	Represents a "WHEN... THEN..." portation of a CASE WHEN clause in an expression. More...

Public Types
typedef QList< QgsExpressionNodeCondition::WhenThen * >	WhenThenList

Public Types inherited from QgsExpressionNode
enum	NodeType { ntUnaryOperator , ntBinaryOperator , ntInOperator , ntFunction , ntLiteral , ntColumnRef , ntCondition , ntIndexOperator , ntBetweenOperator }
	Known node types. More...

Public Member Functions
	QgsExpressionNodeCondition (const QgsExpressionNodeCondition::WhenThenList &conditions, QgsExpressionNode *elseExp=nullptr)
	Create a new node with the given list of conditions and an optional elseExp expression. More...

	QgsExpressionNodeCondition (QgsExpressionNodeCondition::WhenThenList conditions, QgsExpressionNode elseExp=nullptr)
	Create a new node with the given list of conditions and an optional elseExp expression. More...

	~QgsExpressionNodeCondition () override

QgsExpressionNode *	clone () const override
	Generate a clone of this node. More...

WhenThenList	conditions () const
	The list of WHEN THEN expression parts of the expression. More...

QString	dump () const override
	Dump this node into a serialized (part) of an expression. More...

QgsExpressionNode *	elseExp () const
	The ELSE expression used for the condition. More...

QVariant	evalNode (QgsExpression parent, const QgsExpressionContext context) override
	Abstract virtual eval method Errors are reported to the parent. More...

bool	isStatic (QgsExpression parent, const QgsExpressionContext context) const override
	Returns `true` if this node can be evaluated for a static value. More...

bool	needsGeometry () const override
	Abstract virtual method which returns if the geometry is required to evaluate this expression. More...

QList< const QgsExpressionNode * >	nodes () const override
	Returns a list of all nodes which are used in this expression. More...

QgsExpressionNode::NodeType	nodeType () const override
	Gets the type of this node. More...

bool	prepareNode (QgsExpression parent, const QgsExpressionContext context) override
	Abstract virtual preparation method Errors are reported to the parent. More...

QSet< QString >	referencedColumns () const override
	Abstract virtual method which returns a list of columns required to evaluate this node. More...

QSet< QString >	referencedFunctions () const override
	Returns a set of all functions which are used in this expression. More...

QSet< QString >	referencedVariables () const override
	Returns a set of all variables which are used in this expression. More...

Public Member Functions inherited from QgsExpressionNode
virtual	~QgsExpressionNode ()=default

QVariant	cachedStaticValue () const
	Returns the node's static cached value. More...

virtual QgsExpressionNode *	clone () const =0
	Generate a clone of this node. More...

virtual QString	dump () const =0
	Dump this node into a serialized (part) of an expression. More...

const QgsExpressionNode *	effectiveNode () const
	Returns a reference to the simplest node which represents this node, after any compilation optimizations have been applied. More...

QVariant	eval (QgsExpression parent, const QgsExpressionContext context)
	Evaluate this node with the given context and parent. More...

bool	hasCachedStaticValue () const
	Returns `true` if the node can be replaced by a static cached value. More...

virtual bool	isStatic (QgsExpression parent, const QgsExpressionContext context) const =0
	Returns `true` if this node can be evaluated for a static value. More...

virtual bool	needsGeometry () const =0
	Abstract virtual method which returns if the geometry is required to evaluate this expression. More...

virtual QList< const QgsExpressionNode * >	nodes () const =0
	Returns a list of all nodes which are used in this expression. More...

virtual QgsExpressionNode::NodeType	nodeType () const =0
	Gets the type of this node. More...

bool	prepare (QgsExpression parent, const QgsExpressionContext context)
	Prepare this node for evaluation. More...

virtual QSet< QString >	referencedColumns () const =0
	Abstract virtual method which returns a list of columns required to evaluate this node. More...

virtual QSet< QString >	referencedFunctions () const =0
	Returns a set of all functions which are used in this expression. More...

virtual QSet< QString >	referencedVariables () const =0
	Returns a set of all variables which are used in this expression. More...

Additional Inherited Members
Public Attributes inherited from QgsExpressionNode
int	parserFirstColumn = 0
	First column in the parser this node was found. More...

int	parserFirstLine = 0
	First line in the parser this node was found. More...

int	parserLastColumn = 0
	Last column in the parser this node was found. More...

int	parserLastLine = 0
	Last line in the parser this node was found. More...

Protected Member Functions inherited from QgsExpressionNode
	QgsExpressionNode ()=default
	Constructor. More...

	QgsExpressionNode (const QgsExpressionNode &other)
	Copy constructor. More...

void	cloneTo (QgsExpressionNode *target) const
	Copies the members of this node to the node provided in target. More...

QgsExpressionNode &	operator= (const QgsExpressionNode &other)
	Assignment operator. More...

Protected Attributes inherited from QgsExpressionNode
QVariant	mCachedStaticValue
	Contains the static, precalculated value for the node if mHasCachedValue is `true`. More...

std::unique_ptr< QgsExpressionNode >	mCompiledSimplifiedNode
	Contains a compiled node which represents a simplified version of this node as a result of compilation optimizations. More...

bool	mHasCachedValue = false
	`true` if the node has a static, precalculated value. More...

Detailed Description

An expression node for CASE WHEN clauses.

Definition at line 560 of file qgsexpressionnodeimpl.h.

Member Typedef Documentation

◆ WhenThenList

typedef QList<QgsExpressionNodeCondition::WhenThen *> QgsExpressionNodeCondition::WhenThenList

Definition at line 610 of file qgsexpressionnodeimpl.h.

Constructor & Destructor Documentation

◆ QgsExpressionNodeCondition() [1/2]

QgsExpressionNodeCondition::QgsExpressionNodeCondition	(	QgsExpressionNodeCondition::WhenThenList *	conditions,
		QgsExpressionNode *	elseExp = `nullptr`
	)

Create a new node with the given list of conditions and an optional elseExp expression.

Definition at line 1542 of file qgsexpressionnodeimpl.cpp.

◆ QgsExpressionNodeCondition() [2/2]

QgsExpressionNodeCondition::QgsExpressionNodeCondition	(	const QgsExpressionNodeCondition::WhenThenList &	conditions,
		QgsExpressionNode *	elseExp = `nullptr`
	)

inline

Create a new node with the given list of conditions and an optional elseExp expression.

Definition at line 620 of file qgsexpressionnodeimpl.h.

◆ ~QgsExpressionNodeCondition()

QgsExpressionNodeCondition::~QgsExpressionNodeCondition ( )

override

Definition at line 1549 of file qgsexpressionnodeimpl.cpp.

Member Function Documentation

◆ clone()

QgsExpressionNode * QgsExpressionNodeCondition::clone ( ) const

overridevirtual

Generate a clone of this node.

Ownership is transferred to the caller.

Returns: a deep copy of this node.

Implements QgsExpressionNode.

Definition at line 1731 of file qgsexpressionnodeimpl.cpp.

◆ conditions()

WhenThenList QgsExpressionNodeCondition::conditions ( ) const

inline

The list of WHEN THEN expression parts of the expression.

Returns: The list of WHEN THEN expression parts of the expression.

Definition at line 636 of file qgsexpressionnodeimpl.h.

◆ dump()

QString QgsExpressionNodeCondition::dump ( ) const

overridevirtual

Dump this node into a serialized (part) of an expression.

The returned expression does not necessarily literally match the original expression, it's just guaranteed to behave the same way.

Implements QgsExpressionNode.

Definition at line 1646 of file qgsexpressionnodeimpl.cpp.

◆ elseExp()

QgsExpressionNode * QgsExpressionNodeCondition::elseExp ( ) const

inline

The ELSE expression used for the condition.

Returns: The ELSE expression used for the condition.

Definition at line 642 of file qgsexpressionnodeimpl.h.

◆ evalNode()

QVariant QgsExpressionNodeCondition::evalNode	(	QgsExpression *	parent,
		const QgsExpressionContext *	context
	)

overridevirtual

Abstract virtual eval method Errors are reported to the parent.

Since: QGIS 3.0

Implements QgsExpressionNode.

Definition at line 1560 of file qgsexpressionnodeimpl.cpp.

◆ isStatic()

bool QgsExpressionNodeCondition::isStatic	(	QgsExpression *	parent,
		const QgsExpressionContext *	context
	)		const

overridevirtual

Returns true if this node can be evaluated for a static value.

This is used during the prepare() step and in case it returns true, the value of this node will already be evaluated and the result cached (and therefore not re-evaluated in subsequent calls to eval()). In case this returns true, prepareNode() will never be called.

Since: QGIS 3.0

Implements QgsExpressionNode.

Definition at line 1743 of file qgsexpressionnodeimpl.cpp.

◆ needsGeometry()

bool QgsExpressionNodeCondition::needsGeometry ( ) const

overridevirtual

Abstract virtual method which returns if the geometry is required to evaluate this expression.

This needs to call needsGeometry() recursively on any child nodes.

Returns: true if a geometry is required to evaluate this expression

Implements QgsExpressionNode.

Definition at line 1719 of file qgsexpressionnodeimpl.cpp.

◆ nodes()

QList< const QgsExpressionNode * > QgsExpressionNodeCondition::nodes ( ) const

overridevirtual

Returns a list of all nodes which are used in this expression.

Note: not available in Python bindings

Since: QGIS 3.2

Implements QgsExpressionNode.

Definition at line 1704 of file qgsexpressionnodeimpl.cpp.

◆ nodeType()

QgsExpressionNode::NodeType QgsExpressionNodeCondition::nodeType ( ) const

overridevirtual

Gets the type of this node.

Returns: The type of this node

Implements QgsExpressionNode.

Definition at line 1555 of file qgsexpressionnodeimpl.cpp.

◆ prepareNode()

bool QgsExpressionNodeCondition::prepareNode	(	QgsExpression *	parent,
		const QgsExpressionContext *	context
	)

overridevirtual

Abstract virtual preparation method Errors are reported to the parent.

Since: QGIS 3.0

Implements QgsExpressionNode.

Definition at line 1586 of file qgsexpressionnodeimpl.cpp.

◆ referencedColumns()

QSet< QString > QgsExpressionNodeCondition::referencedColumns ( ) const

overridevirtual

Abstract virtual method which returns a list of columns required to evaluate this node.

When reimplementing this, you need to return any column that is required to evaluate this node and in addition recursively collect all the columns required to evaluate child nodes.

Warning: If the expression has been prepared via a call to QgsExpression::prepare(), or a call to QgsExpressionNode::prepare() for a node has been made, then some nodes in the expression may have been determined to evaluate to a static pre-calculatable value. In this case the results will omit attribute indices which are used by these pre-calculated nodes, regardless of their actual referenced columns. If you are seeking to use these functions to introspect an expression you must take care to do this with an unprepared expression node.

Returns: A list of columns required to evaluate this expression

Implements QgsExpressionNode.

Definition at line 1659 of file qgsexpressionnodeimpl.cpp.

◆ referencedFunctions()

QSet< QString > QgsExpressionNodeCondition::referencedFunctions ( ) const

overridevirtual

Returns a set of all functions which are used in this expression.

Note: In contrast to the referencedColumns() function this method is not affected by any previous calls to QgsExpressionNode::prepare().

Implements QgsExpressionNode.

Definition at line 1690 of file qgsexpressionnodeimpl.cpp.

◆ referencedVariables()

QSet< QString > QgsExpressionNodeCondition::referencedVariables ( ) const

overridevirtual

Returns a set of all variables which are used in this expression.

Note: In contrast to the referencedColumns() function this method is not affected by any previous calls to QgsExpressionNode::prepare().

Implements QgsExpressionNode.

Definition at line 1676 of file qgsexpressionnodeimpl.cpp.

The documentation for this class was generated from the following files:

/build/qgis-3.28.0+99sid/src/core/expression/qgsexpressionnodeimpl.h
/build/qgis-3.28.0+99sid/src/core/expression/qgsexpressionnodeimpl.cpp

Classes

Public Types

Public Member Functions

Additional Inherited Members

Detailed Description

Member Typedef Documentation

◆ WhenThenList

Constructor & Destructor Documentation

◆ QgsExpressionNodeCondition() [1/2]

◆ QgsExpressionNodeCondition() [2/2]

◆ ~QgsExpressionNodeCondition()

Member Function Documentation

◆ clone()

◆ conditions()

◆ dump()

◆ elseExp()

◆ evalNode()

◆ isStatic()

◆ needsGeometry()

◆ nodes()

◆ nodeType()

◆ prepareNode()

◆ referencedColumns()

◆ referencedFunctions()

◆ referencedVariables()