Abstract base class for all nodes that can appear in an expression. More...

#include <qgsexpressionnode.h>

Inheritance diagram for QgsExpressionNode:

[legend]

Classes
struct	NamedNode
	Named node. More...

class	NodeList
	A list of expression nodes. More...

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

Public Member Functions
virtual	~QgsExpressionNode ()=default

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...

QVariant	eval (QgsExpression parent, const QgsExpressionContext context)
	Evaluate this node with the given context and parent. 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...

Public Attributes
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
void	cloneTo (QgsExpressionNode *target) const
	Copies the members of this node to the node provided in target. More...

Detailed Description

Abstract base class for all nodes that can appear in an expression.

Definition at line 34 of file qgsexpressionnode.h.

Member Enumeration Documentation

◆ NodeType

enum QgsExpressionNode::NodeType

Known node types.

Enumerator
ntUnaryOperator	See also QgsExpression::Node::NodeUnaryOperator
ntBinaryOperator	See also QgsExpression::Node::NodeBinaryOperator
ntInOperator	See also QgsExpression::Node::NodeInOperator
ntFunction	See also QgsExpression::Node::NodeFunction
ntLiteral	See also QgsExpression::Node::NodeLiteral
ntColumnRef	See also QgsExpression::Node::NodeColumnRef
ntCondition	See also QgsExpression::Node::NodeCondition
ntIndexOperator	Index operator.

Definition at line 74 of file qgsexpressionnode.h.

Constructor & Destructor Documentation

◆ ~QgsExpressionNode()

virtual QgsExpressionNode::~QgsExpressionNode ( )

virtualdefault

Member Function Documentation

◆ clone()

virtual QgsExpressionNode* QgsExpressionNode::clone ( ) const

pure virtual

Generate a clone of this node.

Ownership is transferred to the caller.

Returns: a deep copy of this node.

Implemented in QgsExpressionNodeCondition, QgsExpressionNodeColumnRef, QgsExpressionNodeLiteral, QgsExpressionNodeFunction, QgsExpressionNodeInOperator, QgsExpressionNodeIndexOperator, QgsExpressionNodeBinaryOperator, and QgsExpressionNodeUnaryOperator.

◆ cloneTo()

void QgsExpressionNode::cloneTo ( QgsExpressionNode * target ) const

protected

Copies the members of this node to the node provided in target.

Needs to be called by all subclasses as part of their clone() implementation.

Note: Not available in python bindings, QgsExpression::Node is not going to be subclassed from python. If that's what you are looking for, look into writing a custom python expression function.

Since: QGIS 3.0

Definition at line 51 of file qgsexpressionnode.cpp.

◆ dump()

virtual QString QgsExpressionNode::dump ( ) const

pure virtual

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.

Implemented in QgsExpressionNodeCondition, QgsExpressionNodeColumnRef, QgsExpressionNodeLiteral, QgsExpressionNodeFunction, QgsExpressionNodeInOperator, QgsExpressionNodeIndexOperator, QgsExpressionNodeBinaryOperator, and QgsExpressionNodeUnaryOperator.

◆ eval()

QVariant QgsExpressionNode::eval	(	QgsExpression *	parent,
		const QgsExpressionContext *	context
	)

Evaluate this node with the given context and parent.

This will return a cached value if it has been determined to be static during the prepare() execution.

Since: QGIS 2.12

Definition at line 20 of file qgsexpressionnode.cpp.

◆ isStatic()

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

pure virtual

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

Implemented in QgsExpressionNodeCondition, QgsExpressionNodeColumnRef, QgsExpressionNodeLiteral, QgsExpressionNodeFunction, QgsExpressionNodeInOperator, QgsExpressionNodeIndexOperator, QgsExpressionNodeBinaryOperator, and QgsExpressionNodeUnaryOperator.

◆ needsGeometry()

virtual bool QgsExpressionNode::needsGeometry ( ) const

pure virtual

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

Implemented in QgsExpressionNodeCondition, QgsExpressionNodeColumnRef, QgsExpressionNodeLiteral, QgsExpressionNodeFunction, QgsExpressionNodeInOperator, QgsExpressionNodeIndexOperator, QgsExpressionNodeBinaryOperator, and QgsExpressionNodeUnaryOperator.

◆ nodes()

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

pure virtual

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

Note: not available in Python bindings

Since: QGIS 3.2

Implemented in QgsExpressionNodeCondition, QgsExpressionNodeColumnRef, QgsExpressionNodeLiteral, QgsExpressionNodeFunction, QgsExpressionNodeInOperator, QgsExpressionNodeIndexOperator, QgsExpressionNodeBinaryOperator, and QgsExpressionNodeUnaryOperator.

◆ nodeType()

virtual QgsExpressionNode::NodeType QgsExpressionNode::nodeType ( ) const

pure virtual

Gets the type of this node.

Returns: The type of this node

Implemented in QgsExpressionNodeCondition, QgsExpressionNodeColumnRef, QgsExpressionNodeLiteral, QgsExpressionNodeFunction, QgsExpressionNodeInOperator, QgsExpressionNodeIndexOperator, QgsExpressionNodeBinaryOperator, and QgsExpressionNodeUnaryOperator.

◆ prepare()

bool QgsExpressionNode::prepare	(	QgsExpression *	parent,
		const QgsExpressionContext *	context
	)

Prepare this node for evaluation.

This will check if the node content is static and in this case cache the value. If it's not static it will call prepareNode() to allow the node to do initialization work like for example resolving a column name to an attribute index.

Since: QGIS 2.12

Definition at line 33 of file qgsexpressionnode.cpp.

◆ referencedColumns()

virtual QSet<QString> QgsExpressionNode::referencedColumns ( ) const

pure virtual

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.

Returns: A list of columns required to evaluate this expression

Implemented in QgsExpressionNodeCondition, QgsExpressionNodeColumnRef, QgsExpressionNodeLiteral, QgsExpressionNodeFunction, QgsExpressionNodeInOperator, QgsExpressionNodeIndexOperator, QgsExpressionNodeBinaryOperator, and QgsExpressionNodeUnaryOperator.

◆ referencedFunctions()

virtual QSet<QString> QgsExpressionNode::referencedFunctions ( ) const

pure virtual

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

Implemented in QgsExpressionNodeCondition, QgsExpressionNodeColumnRef, QgsExpressionNodeLiteral, QgsExpressionNodeFunction, QgsExpressionNodeInOperator, QgsExpressionNodeIndexOperator, QgsExpressionNodeBinaryOperator, and QgsExpressionNodeUnaryOperator.

◆ referencedVariables()

virtual QSet<QString> QgsExpressionNode::referencedVariables ( ) const

pure virtual

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

Implemented in QgsExpressionNodeCondition, QgsExpressionNodeColumnRef, QgsExpressionNodeLiteral, QgsExpressionNodeFunction, QgsExpressionNodeInOperator, QgsExpressionNodeIndexOperator, QgsExpressionNodeBinaryOperator, and QgsExpressionNodeUnaryOperator.

Member Data Documentation

◆ parserFirstColumn

int QgsExpressionNode::parserFirstColumn = 0

First column in the parser this node was found.

Note: This might not be complete for all nodes. Currently only

See also: QgsExpressionNode has this complete

Definition at line 286 of file qgsexpressionnode.h.

◆ parserFirstLine

int QgsExpressionNode::parserFirstLine = 0

First line in the parser this node was found.

Note: This might not be complete for all nodes. Currently only

See also: QgsExpressionNode has this complete

Definition at line 279 of file qgsexpressionnode.h.

◆ parserLastColumn

int QgsExpressionNode::parserLastColumn = 0

Last column in the parser this node was found.

Note: This might not be complete for all nodes. Currently only

See also: QgsExpressionNode has this complete

Definition at line 300 of file qgsexpressionnode.h.

◆ parserLastLine

int QgsExpressionNode::parserLastLine = 0

Last line in the parser this node was found.

Note: This might not be complete for all nodes. Currently only

See also: QgsExpressionNode has this complete

Definition at line 293 of file qgsexpressionnode.h.

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

/build/qgis-3.16.0+99unstable/src/core/expression/qgsexpressionnode.h
/build/qgis-3.16.0+99unstable/src/core/expression/qgsexpressionnode.cpp

Classes

Public Types

Public Member Functions

Public Attributes

Protected Member Functions

Detailed Description

Member Enumeration Documentation

◆ NodeType

Constructor & Destructor Documentation

◆ ~QgsExpressionNode()

Member Function Documentation

◆ clone()

◆ cloneTo()

◆ dump()

◆ eval()

◆ isStatic()

◆ needsGeometry()

◆ nodes()

◆ nodeType()

◆ prepare()

◆ referencedColumns()

◆ referencedFunctions()

◆ referencedVariables()

Member Data Documentation

◆ parserFirstColumn

◆ parserFirstLine

◆ parserLastColumn

◆ parserLastLine