[clang-tools-extra] [clang-tidy] Add `modernize-use-bit-cast` check (PR #189962)

via cfe-commits cfe-commits at lists.llvm.org
Sun Apr 19 23:03:06 PDT 2026


================
@@ -0,0 +1,279 @@
+//===----------------------------------------------------------------------===//
+//
+// 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 "UseBitCastCheck.h"
+#include "clang/AST/ASTContext.h"
+#include "clang/AST/Expr.h"
+#include "clang/AST/ExprCXX.h"
+#include "clang/AST/Type.h"
+#include "clang/ASTMatchers/ASTMatchFinder.h"
+#include "clang/Lex/Lexer.h"
+#include "llvm/ADT/STLExtras.h"
+#include "llvm/ADT/Twine.h"
+#include <cassert>
+
+using namespace clang::ast_matchers;
+
+namespace clang::tidy::modernize {
+
+static bool isSupportedMemcpyObjectExpr(const Expr *ExprNode) {
+  ExprNode = ExprNode->IgnoreParenImpCasts();
+
+  if (isa<DeclRefExpr>(ExprNode))
+    return true;
+
+  const auto *Member = dyn_cast<MemberExpr>(ExprNode);
+  if (!Member || !isa<FieldDecl>(Member->getMemberDecl()))
+    if (const auto *MemberPointer = dyn_cast<BinaryOperator>(ExprNode))
+      if (MemberPointer->getOpcode() == BO_PtrMemD ||
+          MemberPointer->getOpcode() == BO_PtrMemI)
+        return isSupportedMemcpyObjectExpr(MemberPointer->getLHS());
+
+  return Member && isSupportedMemcpyObjectExpr(Member->getBase());
+}
+
+static const Expr *extractMemcpyObjectExpr(const Expr *ExprNode) {
+  ExprNode = ExprNode->IgnoreParenCasts();
+  const auto *AddressOf = dyn_cast<UnaryOperator>(ExprNode);
+  if (!AddressOf || AddressOf->getOpcode() != UO_AddrOf)
+    return nullptr;
+
+  const Expr *ObjectExpr = AddressOf->getSubExpr()->IgnoreParenImpCasts();
+  return isSupportedMemcpyObjectExpr(ObjectExpr) ? ObjectExpr : nullptr;
+}
+
+static bool isBitCastableMemcpyObjectType(QualType Type,
+                                          const ASTContext &Context) {
+  Type = Type.getCanonicalType().getNonReferenceType();
+  return !Type.isNull() && !Type.isVolatileQualified() &&
+         !Type->isAnyPointerType() && !Type->isFunctionType() &&
+         Type.isTriviallyCopyableType(Context) &&
+         Type.isBitwiseCloneableType(Context);
+}
+
+static bool canAssignBitCastResult(QualType Type) {
+  Type = Type.getCanonicalType().getNonReferenceType();
+  if (Type.isNull() || Type.isConstQualified() || Type->isArrayType())
+    return false;
+
+  const auto *Record = Type->getAsCXXRecordDecl();
+  return !Record || Record->hasSimpleCopyAssignment() ||
+         Record->hasSimpleMoveAssignment();
+}
+
+static bool isSameUnqualifiedCanonicalType(QualType LHS, QualType RHS) {
+  return LHS.getCanonicalType().getUnqualifiedType() ==
+         RHS.getCanonicalType().getUnqualifiedType();
+}
+
+static bool isMatchingSizeOfExpression(const Expr *SizeExpr, QualType SrcType,
+                                       QualType DstType,
+                                       const ASTContext &Context) {
+  const auto *UnaryExpr =
+      dyn_cast<UnaryExprOrTypeTraitExpr>(SizeExpr->IgnoreParenImpCasts());
+  if (!UnaryExpr || UnaryExpr->getKind() != UETT_SizeOf ||
+      SizeExpr->getBeginLoc().isMacroID())
+    return false;
+
+  const QualType SizeType = UnaryExpr->getTypeOfArgument();
+  if (SizeType.isNull())
+    return false;
+
+  const QualType SizeCanonical =
+      SizeType.getCanonicalType().getUnqualifiedType();
+  const QualType SrcCanonical = SrcType.getCanonicalType().getUnqualifiedType();
+  const QualType DstCanonical = DstType.getCanonicalType().getUnqualifiedType();
+  if (SizeCanonical != SrcCanonical && SizeCanonical != DstCanonical)
+    return false;
+
+  return Context.getTypeSizeInChars(SrcCanonical) ==
+         Context.getTypeSizeInChars(DstCanonical);
+}
+
+static bool isStatementBody(const Stmt *Current, const Stmt *Parent) {
+  if (const auto *Block = dyn_cast<CompoundStmt>(Parent))
+    return llvm::is_contained(Block->body(), Current);
+
+  if (const auto *If = dyn_cast<IfStmt>(Parent))
+    return If->getThen() == Current || If->getElse() == Current;
+  if (const auto *While = dyn_cast<WhileStmt>(Parent))
+    return While->getBody() == Current;
+  if (const auto *Do = dyn_cast<DoStmt>(Parent))
+    return Do->getBody() == Current;
+  if (const auto *For = dyn_cast<ForStmt>(Parent))
+    return For->getBody() == Current;
+  if (const auto *RangeFor = dyn_cast<CXXForRangeStmt>(Parent))
+    return RangeFor->getBody() == Current;
+  if (const auto *Label = dyn_cast<LabelStmt>(Parent))
+    return Label->getSubStmt() == Current;
+  if (const auto *Case = dyn_cast<SwitchCase>(Parent))
+    return Case->getSubStmt() == Current;
+  if (const auto *Attributed = dyn_cast<AttributedStmt>(Parent))
+    return Attributed->getSubStmt() == Current;
+
+  return false;
+}
+
+namespace {
+
+AST_MATCHER(CallExpr, hasBitCastReplacementContext) {
+  const Stmt *Current = &Node;
+  const BinaryOperator *DiscardedComma = nullptr;
+
+  while (true) {
+    auto Parents = Finder->getASTContext().getParents(*Current);
+    if (Parents.size() != 1)
+      return false;
+
+    if (const auto *ParentExpr = Parents[0].get<Expr>()) {
+      if (isa<ExprWithCleanups, ImplicitCastExpr, MaterializeTemporaryExpr,
+              CXXBindTemporaryExpr, ParenExpr>(ParentExpr)) {
+        Current = ParentExpr;
+        continue;
+      }
+
+      if (const auto *Cast = dyn_cast<CastExpr>(ParentExpr)) {
+        if (Cast->getCastKind() != CK_ToVoid)
+          return false;
+
+        if (!DiscardedComma) {
+          Builder->setBinding("replacementRoot", DynTypedNode::create(*Cast));
+          return true;
+        }
+
+        Current = Cast;
+        continue;
+      }
+
+      const auto *Comma = dyn_cast<BinaryOperator>(ParentExpr);
+      if (!Comma || Comma->getOpcode() != BO_Comma)
+        return false;
+      if (Comma->getLHS() == Current) {
+        Builder->setBinding("replacementRoot", DynTypedNode::create(Node));
+        Builder->setBinding("discardedComma", DynTypedNode::create(*Comma));
+        return true;
+      }
+      if (Comma->getRHS() != Current)
+        return false;
+
+      DiscardedComma = Comma;
+      Current = Comma;
+      continue;
+    }
+
+    const auto *ParentStmt = Parents[0].get<Stmt>();
+    if (!ParentStmt || !isStatementBody(Current, ParentStmt))
+      return false;
+
+    Builder->setBinding("replacementRoot", DynTypedNode::create(Node));
+    if (DiscardedComma)
+      Builder->setBinding("discardedComma",
+                          DynTypedNode::create(*DiscardedComma));
+    return true;
+  }
+}
+
+AST_MATCHER(CallExpr, isBitCastMemcpyCandidate) {
+  if (Node.getNumArgs() != 3 || Node.getBeginLoc().isMacroID())
+    return false;
+
+  const auto *DstExpr = extractMemcpyObjectExpr(Node.getArg(0));
+  const auto *SrcExpr = extractMemcpyObjectExpr(Node.getArg(1));
+  if (!DstExpr || !SrcExpr || DstExpr->getBeginLoc().isMacroID() ||
+      SrcExpr->getBeginLoc().isMacroID())
+    return false;
+
+  const auto &Context = Finder->getASTContext();
+  const QualType DstType = DstExpr->getType().getNonReferenceType();
+  const QualType SrcType = SrcExpr->getType().getNonReferenceType();
+
+  if (!isBitCastableMemcpyObjectType(DstType, Context) ||
+      !isBitCastableMemcpyObjectType(SrcType, Context) ||
+      !canAssignBitCastResult(DstType) ||
+      isSameUnqualifiedCanonicalType(SrcType, DstType) ||
+      !isMatchingSizeOfExpression(Node.getArg(2), SrcType, DstType, Context))
+    return false;
+
+  Builder->setBinding("dstExpr", DynTypedNode::create(*DstExpr));
+  Builder->setBinding("srcExpr", DynTypedNode::create(*SrcExpr));
+  return true;
+}
+
+} // namespace
+
+static StringRef getSourceText(const Expr *ExprNode, const SourceManager &SM,
+                               const LangOptions &LangOpts) {
+  return Lexer::getSourceText(
+      CharSourceRange::getTokenRange(ExprNode->getSourceRange()), SM, LangOpts);
+}
+
+UseBitCastCheck::UseBitCastCheck(StringRef Name, ClangTidyContext *Context)
+    : ClangTidyCheck(Name, Context),
+      IncludeInserter(Options.getLocalOrGlobal("IncludeStyle",
+                                               utils::IncludeSorter::IS_LLVM),
+                      areDiagsSelfContained()) {}
+
+void UseBitCastCheck::storeOptions(ClangTidyOptions::OptionMap &Opts) {
+  Options.store(Opts, "IncludeStyle", IncludeInserter.getStyle());
+}
+
+void UseBitCastCheck::registerPPCallbacks(const SourceManager &SM,
+                                          Preprocessor *PP,
+                                          Preprocessor *ModuleExpanderPP) {
+  IncludeInserter.registerPreprocessor(PP);
+}
+
+void UseBitCastCheck::registerMatchers(MatchFinder *Finder) {
+  Finder->addMatcher(callExpr(callee(functionDecl(hasName("::memcpy"))),
+                              hasBitCastReplacementContext(),
+                              isBitCastMemcpyCandidate())
+                         .bind("memcpy"),
+                     this);
+}
+
+void UseBitCastCheck::check(const MatchFinder::MatchResult &Result) {
+  const auto *MemcpyCall = Result.Nodes.getNodeAs<CallExpr>("memcpy");
+  const auto *DstExpr = Result.Nodes.getNodeAs<Expr>("dstExpr");
+  const auto *SrcExpr = Result.Nodes.getNodeAs<Expr>("srcExpr");
+  const auto *ReplacementRoot = Result.Nodes.getNodeAs<Expr>("replacementRoot");
+  const auto *DiscardedComma =
+      Result.Nodes.getNodeAs<BinaryOperator>("discardedComma");
+  assert(MemcpyCall);
+  assert(DstExpr);
+  assert(SrcExpr);
+  assert(ReplacementRoot);
+
+  const SourceManager &SM = *Result.SourceManager;
+  const LangOptions &LangOpts = getLangOpts();
+  StringRef DstText = getSourceText(DstExpr, SM, LangOpts);
+  StringRef SrcText = getSourceText(SrcExpr, SM, LangOpts);
+  if (DstText.empty() || SrcText.empty())
+    return;
+
+  const PrintingPolicy &Policy = Result.Context->getPrintingPolicy();
+  const QualType DstType =
+      DstExpr->getType().getNonReferenceType().getUnqualifiedType();
+  const std::string DstTypeName = DstType.getAsString(Policy);
+  const std::string Replacement =
+      [&](const llvm::Twine &Assignment) -> std::string {
+    if (DiscardedComma)
+      return ("(void)(" + Assignment + ")").str();
+    return Assignment.str();
+  }(llvm::Twine(DstText) + " = std::bit_cast<" + DstTypeName + ">(" + SrcText +
----------------
serge-sans-paille wrote:

you could benefit from using llvm's format here

https://github.com/llvm/llvm-project/pull/189962


More information about the cfe-commits mailing list