Cpp.AbstractPointerDeclarator Class

Namespace: Cpp
Superclasses: AstNodeProperties

Represents the asbtract_pointer_declarator nodes in the syntax tree of your code

Since R2026a

Description

The PQL class AbstractPointerDeclarator represents the node abstract_pointer_declarator in the syntax tree of your code.

void read_data(const int *);

The preceding code contains an abstract pointer declarator in the parameter list of read_data.

Predicates

Type

Type	Raisable	Printable
AbstractPointerDeclarator	Yes	No

Syntaxes

This class defines these predicates that act on the objects of this class. In addition, objects of this class can access the predicates defined by the base class AstNodeProperties. An object of this class is an object of AstNodeProperties class.

Predicates	Description	Example
is(required AbstractPointerDeclarator &decl)	Matches any abstract_pointer_declarator node and returns it as &decl, useful to directly examine a pointer declarator.	This PQL defect checks for occurrences of abstract_pointer_declarator nodes. defect defectIs = when Cpp.AbstractPointerDeclarator.is(&decl) and decl.nodeText(&txt) raise "AbstractPointerDeclarator.is matched: \"{txt}\"" on decl In this C++ code, the defect finds the abstract pointer declarator. void read_data(const int *); //macthes *
cast(Cpp.Node.Node node, required AbstractPointerDeclarator &cast)	Checks whether a given generic node is an abstract_pointer_declarator and, if so, returns it as &cast for further inspection.	This PQL defect checks whether a generic node is specifically an abstract_pointer_declarator. defect defectCast = when Cpp.Node.is(&node, &,&,&) and Cpp.AbstractPointerDeclarator.cast(node, &decl) and decl.nodeText(&txt) raise "AbstractPointerDeclarator.cast matched: \"{txt}\"" on decl In this C++ code, the defect finds the abstract pointer declarator in the function foo(). void foo() { void* raw_ptr = (int*) 0x1000; }
isa(Cpp.Node.Node node)	Returns true if node is an abstract_pointer_declarator; useful for boolean checks or negations.	This PQL defect checks whether a node is an abstract_pointer_declarator using a boolean-style predicate. defect defectIsa = when Cpp.Node.is(&node, &,&,&) and Cpp.AbstractPointerDeclarator.isa(node) raise "Node is an AbstractPointerDeclarator" on node In this C++ code, the defect finds the abstract pointer declarator in the function foo(). void foo() { void* raw_ptr = (int*) 0x1000; }
declarator(AbstractPointerDeclarator self, Cpp.Node.Node &child)	Matches the nested declarator inside an abstract_pointer_declarator (e.g., the inner pointer or direct declarator).	This PQL defect checks for the nested declarator node contained by an abstract_pointer_declarator. defect defectDeclarator = when Cpp.AbstractPointerDeclarator.is(&decl) and decl.declarator(&inner) and inner.nodeText(&txt) raise "AbstractPointerDeclarator.declarator matched: \"{txt}\"" on decl
typeQualifier(AbstractPointerDeclarator self, Cpp.Node.Node &child)	Matches a type qualifier (e.g., const, volatile) that modifies the pointer in an abstract_pointer_declarator.	This PQL defect checks for type qualifiers attached to pointer declarators. defect defectTypeQualifier = when Cpp.AbstractPointerDeclarator.is(&decl) and decl.typeQualifier(&tq) and tq.nodeText(&txt) raise "AbstractPointerDeclarator.typeQualifier matched: \"{txt}\"" on decl In this C++ code, the defect finds the const qualifier in (int* const) abstract declarator. void foo() { int* raw_ptr = (int* const) 0x1000; }
msPointerModifier(AbstractPointerDeclarator self, Cpp.Node.Node &child)	Matches Microsoft-specific pointer modifiers, such as __restrict, that are present an abstract_pointer_declarator.	This PQL defect checks for MSVC pointer modifiers on abstract_pointer_declarator nodes. defect defectMsPointerModifier = when Cpp.AbstractPointerDeclarator.is(&decl) and decl.msPointerModifier(&mod) and mod.nodeText(&txt) raise "AbstractPointerDeclarator.msPointerModifier matched: \"{txt}\"" on decl In this C++ code, the defect finds the MSVC modifier __ptr32 on the pointer declarator. void foo() { int* raw_ptr = (int* __restrict const) 0x1000; }
getEnclosingAbstractPointerDeclarator(Cpp.Node.Node child, required AbstractPointerDeclarator &parent)	Finds the closest enclosing abstract_pointer_declarator ancestor of child and returns it as &parent.	This PQL defect checks for the nearest abstract_pointer_declarator that surrounds a ms_pointer_modifier node. defect defectGetEnclosing = when Cpp.Node.is(&node, &,&,&) and Cpp.MsPointerModifier.isa(node) and Cpp.AbstractPointerDeclarator.getEnclosingAbstractPointerDeclarator(node, &parent) and parent.nodeText(&txt) raise "Enclosing AbstractPointerDeclarator of an MS pointer modifier node: \"{txt}\"" on parent In this C++ code, the defect locates the enclosing pointer declarator around the const token in int * const *. void foo() { int* raw_ptr = (int* __restrict const) 0x1000; }
isEnclosedInAbstractPointerDeclarator(Cpp.Node.Node child)	Matches every abstract_pointer_declarator ancestor of child; useful to enumerate all enclosing pointer declarators.	This PQL defect checks for an abstract_pointer_declarator ancestors of a ms_restrict_modifier node. defect defectIsEnclosedIn = when Cpp.Node.is(&node, &,&,&) and Cpp.MsRestrictModifier.isa(node) and Cpp.AbstractPointerDeclarator.isEnclosedInAbstractPointerDeclarator(node) and node.nodeText(&txt) raise "restrict with an ancestor AbstractPointerDeclarator: \"{txt}\"" on node In this C++ code, the defect lists both pointer declarators that enclose the base declarator in int * const *. void foo() { int* raw_ptr = (int* __restrict const) 0x1000; }

Version History

Introduced in R2026a