Cpp.StringContent Class

Namespace: Cpp
Superclasses: AstNodeProperties

Represents the string_content nodes in the syntax tree of your code

Since R2026a

Description

The PQL class Cpp.StringContent represents the node string_content in the syntax tree of your code.

void test_string_content() {
    const char* s1 = "Hello";
    const char* s2 = "World\n";
    const char* s3 = "A \"quoted\" string";
}

The three string literals in this function contain string_content nodes for their literal content.

Predicates

expand all

Type

Type	Raisable	Printable
`StringContent`	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

Predicates	Description	Example
`is(required Cpp.StringContent &expr)`	Bind the current `string_content` node to `expr` so you can inspect its properties or report on it.	This PQL defect checks for every `string_content` node in the code. defect StringContentIs = when Cpp.StringContent.is(&sc) and sc.nodeText(&txt) raise "StringContent.is matched: \"{txt}\"" on sc In this C++ code, the defect finds each string literal content and reports its text. #include <iostream> int main() { const char* s = "Hello"; std::cout << s << '\n'; return 0; }
`cast(Cpp.Node.Node node, required Cpp.StringContent &cast)`	Check whether a generic `Node` is a `string_content` and if so bind it to `cast` for further queries.	This PQL defect checks for `string_content` nodes that are descendents of `string_literal` by using the `cast` predicate. defect StringContentCast = when Cpp.StringLiteral.is(&lit) and lit.getADescendant(&STN) and Cpp.StringContent.cast(STN, &sc) and sc.nodeText(&txt) raise "StringContent.cast matched from StringLiteral: {txt} " on sc In this C++ code, the defect finds `World` from the string literal `"World\n"`. #include <cstdio> void f() { const char* s = "World\n"; std::puts(s); }
`isa(Cpp.Node.Node node)`	Return true when the given `Node` is a `string_content` node so you can branch or negate that condition.	This PQL defect checks whether a converted node is a `string_content` and reports when it is not. defect StringContentCast = when Cpp.StringLiteral.is(&lit) and lit.getADescendant(&STN) and Cpp.StringContent.isa(STN) and STN.nodeText(&txt) raise "StringContent.cast matched from StringLiteral: {txt} " on STN In this C++ code, the defect finds the three `string_content` nodes corresponding `A`, `quoted`, and `string`. #include <iostream> int main() { const char* s = "A \"quoted\" string"; std::cout << s << std::endl; return 0; }

is(required Cpp.StringContent &expr)

Bind the current string_content node to expr so you can inspect its properties or report on it.

This PQL defect checks for every string_content node in the code.

defect StringContentIs =
when
    Cpp.StringContent.is(&sc)
    and sc.nodeText(&txt)
raise "StringContent.is matched: \"{txt}\""
on sc

In this C++ code, the defect finds each string literal content and reports its text.

#include <iostream>
int main() {
    const char* s = "Hello";
    std::cout << s << '\n';
    return 0;
}

cast(Cpp.Node.Node node, required Cpp.StringContent &cast)

Check whether a generic Node is a string_content and if so bind it to cast for further queries.

This PQL defect checks for string_content nodes that are descendents of string_literal by using the cast predicate.

defect StringContentCast =
when
    Cpp.StringLiteral.is(&lit)
    and lit.getADescendant(&STN)
    and Cpp.StringContent.cast(STN, &sc)
    and sc.nodeText(&txt)
raise "StringContent.cast matched from StringLiteral: {txt} "
on sc

In this C++ code, the defect finds World from the string literal "World\n".

#include <cstdio>
void f() {
    const char* s = "World\n";
    std::puts(s);
}

isa(Cpp.Node.Node node)

Return true when the given Node is a string_content node so you can branch or negate that condition.

This PQL defect checks whether a converted node is a string_content and reports when it is not.

defect StringContentCast =
when
    Cpp.StringLiteral.is(&lit)
    and lit.getADescendant(&STN)
    and Cpp.StringContent.isa(STN)
    and STN.nodeText(&txt)
raise "StringContent.cast matched from StringLiteral: {txt} "
on STN

In this C++ code, the defect finds the three string_content nodes corresponding A, quoted, and string.

#include <iostream>
int main() {
    const char* s = "A \"quoted\" string";
    std::cout << s << std::endl;
    return 0;
}

Version History

Introduced in R2026a