A C/C++ preprocessor branching directive:
A branching directive has a condition and that condition may be evaluated at compile-time. As a result, the preprocessor will either take the branch, or not take the branch.
However, there are also situations in which a branch’s condition isn’t
evaluated. The obvious case of this is when the directive is contained
within a branch which wasn’t taken. There is also a much more subtle
case involving header guard branches: suitably clever compilers can
notice that a branch is a header guard, and can then subsequently ignore
#include for the file being guarded. It is for this reason that
wasTaken() always holds on header guard branches, but
rarely holds on header guard branches.
Holds if at least one translation unit evaluated this directive’s condition but then didn’t take the branch.
Holds if this directive was either taken by all translation units which evaluated it, or was not taken by any translation unit which evaluated it.
Holds if at least one translation unit evaluated this directive’s condition and subsequently took the branch.
Gets the source of this element: either itself or a macro that expanded to this element.
Holds if this element may be from a library.
Holds if this element may be from source. This predicate holds for all elements, except for those in the dummy file, whose name is the empty string. The dummy file contains declarations that are built directly into the compiler.
Gets a preprocessor branching directive whose condition affects whether this directive is performed.
Gets the name of a primary CodeQL class to which this element belongs.
Gets the closest
Gets the primary file where this element occurs.
Gets the primary location of this element.
Gets the next
Gets the parent scope of this
Holds if this element is affected in any way by a macro. All elements that are totally or partially generated by a macro are included, so this is a super-set of
Holds if this
Holds if this
Holds if this element comes from a macro expansion. Only elements that are entirely generated by a macro are included - for elements that partially come from a macro, see
Gets a textual representation of this element.