Improved the check to correctly handle `[[likely]]` and `[[unlikely]]` attributes placed between the if/else keyword and the opening brace. As of AI Usage: Gemini 3 is used for pre-commit reviewing. Closes https://github.com/llvm/llvm-project/issues/184081
101 lines
3.5 KiB
C++
101 lines
3.5 KiB
C++
//===----------------------------------------------------------------------===//
|
|
//
|
|
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
|
|
// See https://llvm.org/LICENSE.txt for license information.
|
|
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
#include "InconsistentIfElseBracesCheck.h"
|
|
#include "../utils/BracesAroundStatement.h"
|
|
#include "clang/AST/ASTContext.h"
|
|
#include "clang/AST/Stmt.h"
|
|
#include "clang/ASTMatchers/ASTMatchers.h"
|
|
#include "clang/Basic/SourceLocation.h"
|
|
#include "clang/Lex/Lexer.h"
|
|
|
|
using namespace clang::ast_matchers;
|
|
|
|
namespace clang::tidy::readability {
|
|
|
|
/// Look through AttributedStmt wrappers to find the underlying statement.
|
|
static const Stmt *ignoreAttributed(const Stmt *S) {
|
|
if (const auto *AS = dyn_cast<AttributedStmt>(S))
|
|
return AS->getSubStmt();
|
|
return S;
|
|
}
|
|
|
|
/// Check that at least one branch of the \p If statement is a \c CompoundStmt.
|
|
static bool shouldHaveBraces(const IfStmt *If) {
|
|
const Stmt *const Then = ignoreAttributed(If->getThen());
|
|
if (isa<CompoundStmt>(Then))
|
|
return true;
|
|
|
|
if (const Stmt *Else = If->getElse()) {
|
|
Else = ignoreAttributed(Else);
|
|
if (const auto *NestedIf = dyn_cast<const IfStmt>(Else))
|
|
return shouldHaveBraces(NestedIf);
|
|
|
|
return isa<CompoundStmt>(Else);
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
void InconsistentIfElseBracesCheck::registerMatchers(MatchFinder *Finder) {
|
|
Finder->addMatcher(
|
|
ifStmt(hasElse(anything()),
|
|
unless(isConsteval()), // 'if consteval' always has braces
|
|
unless(hasParent(ifStmt())))
|
|
.bind("if_stmt"),
|
|
this);
|
|
}
|
|
|
|
void InconsistentIfElseBracesCheck::check(
|
|
const MatchFinder::MatchResult &Result) {
|
|
const auto *MatchedIf = Result.Nodes.getNodeAs<IfStmt>("if_stmt");
|
|
if (!shouldHaveBraces(MatchedIf))
|
|
return;
|
|
checkIfStmt(Result, MatchedIf);
|
|
}
|
|
|
|
void InconsistentIfElseBracesCheck::checkIfStmt(
|
|
const MatchFinder::MatchResult &Result, const IfStmt *If) {
|
|
const Stmt *Then = ignoreAttributed(If->getThen());
|
|
if (const auto *NestedIf = dyn_cast<const IfStmt>(Then)) {
|
|
// If the then-branch is a nested IfStmt, first we need to add braces to
|
|
// it, then we need to check the inner IfStmt.
|
|
emitDiagnostic(Result, If->getThen(), If->getRParenLoc(), If->getElseLoc());
|
|
|
|
if (shouldHaveBraces(NestedIf))
|
|
checkIfStmt(Result, NestedIf);
|
|
} else if (!isa<CompoundStmt>(Then)) {
|
|
emitDiagnostic(Result, If->getThen(), If->getRParenLoc(), If->getElseLoc());
|
|
}
|
|
|
|
if (const Stmt *Else = If->getElse()) {
|
|
Else = ignoreAttributed(Else);
|
|
if (const auto *NestedIf = dyn_cast<const IfStmt>(Else))
|
|
checkIfStmt(Result, NestedIf);
|
|
else if (!isa<CompoundStmt>(Else))
|
|
emitDiagnostic(Result, If->getElse(), If->getElseLoc());
|
|
}
|
|
}
|
|
|
|
void InconsistentIfElseBracesCheck::emitDiagnostic(
|
|
const MatchFinder::MatchResult &Result, const Stmt *S,
|
|
SourceLocation StartLoc, SourceLocation EndLocHint) {
|
|
if (StartLoc.isMacroID()) {
|
|
diag(StartLoc, "statement should have braces");
|
|
return;
|
|
}
|
|
const utils::BraceInsertionHints Hints = utils::getBraceInsertionsHints(
|
|
S, Result.Context->getLangOpts(), *Result.SourceManager, StartLoc,
|
|
EndLocHint);
|
|
assert(Hints && Hints.offersFixIts() && "Expected hints or fix-its");
|
|
diag(Hints.DiagnosticPos, "statement should have braces")
|
|
<< Hints.openingBraceFixIt() << Hints.closingBraceFixIt();
|
|
}
|
|
|
|
} // namespace clang::tidy::readability
|