Two consecutive question marks signify the start of a trigraph sequence. According to the C Standard, subclause 5.2.1.1 [ISO/IEC 9899:2011],
All occurrences in a source file of the following sequences of three characters (that is, trigraph sequences) are replaced with the corresponding single character.
??=
#
??)
]
??!
|
??(
[
??'
^
??>
}
??/
\
??<
{
??-
~
Noncompliant Code Example
In this noncompliant code example, a++
is not executed because the trigraph sequence ??/
is replaced by \
, logically putting a++
on the same line as the comment:
// What is the value of a now??/ a++;
Compliant Solution
This compliant solution eliminates the accidental introduction of the trigraph by separating the question marks:
// What is the value of a now? ?/ a++;
Noncompliant Code Example
This noncompliant code example includes the trigraph sequence ??!
, which is replaced by the character |
:
size_t i = /* Some initial value */; if (i > 9000) { if (puts("Over 9000!??!") == EOF) { /* Handle error */ } }
This example prints Over 9000!|
if a C-compliant compiler is used.
Compliant Solution
This compliant solution uses string concatenation to concatenate the two question marks; otherwise, they are interpreted as beginning a trigraph sequence:
size_t i = /* Some initial value */; /* Assignment of i */ if (i > 9000) { if (puts("Over 9000!?""?!") == EOF) { /* Handle error */ } }
This code prints Over 9000!??!
, as intended.
Risk Assessment
Inadvertent trigraphs can result in unexpected behavior. Some compilers provide options to warn when trigraphs are encountered or to disable trigraph expansion. Use the warning options, and ensure your code compiles cleanly. (See MSC00-C. Compile cleanly at high warning levels.)
Recommendation | Severity | Likelihood | Remediation Cost | Priority | Level |
---|---|---|---|---|---|
PRE07-C | Low | Unlikely | Medium | P2 | L3 |
Automated Detection
Tool | Version | Checker | Description |
---|---|---|---|
Astrée | 24.04 | trigraph | Fully checked |
Axivion Bauhaus Suite | 7.2.0 | CertC-PRE07 | |
1.2 | CC2.PRE07 | Fully implemented | |
GCC | 4.3.5 | Can detect violation of this recommendation when the | |
Helix QAC | 2024.3 | ||
LDRA tool suite | 9.7.1 | 81 S | Fully implemented |
Parasoft C/C++test | 2023.1 | CERT_C-PRE07-a | Trigraphs shall not be used |
PC-lint Plus | 1.4 | 584, 854, 9060 | Fully supported |
Polyspace Bug Finder | R2024a | CERT C: Rec. PRE07-C | Checks for use of trigraphs (rec. fully covered) |
PRQA QA-C | Unable to render {include} The included page could not be found. | 3601 | Partially implemented |
RuleChecker | 24.04 | trigraph | Fully checked |
SonarQube C/C++ Plugin | 3.11 | TrigraphUsage |
Related Vulnerabilities
Search for vulnerabilities resulting from the violation of this rule on the CERT website.
Related Guidelines
SEI CERT C++ Coding Standard | VOID PRE07-CPP. Avoid using repeated question marks |
MISRA C:2012 | Rule 4.2 (advisory) |
Bibliography
[ISO/IEC 9899:2011] | Subclause 5.2.1.1, "Trigraph Sequences" |