[clang-tools-extra] [clang-tidy] Add `readability-redundant-tag` check (PR #210007)

Yanzuo Liu via cfe-commits cfe-commits at lists.llvm.org
Tue Jul 28 02:57:17 PDT 2026


================
@@ -0,0 +1,112 @@
+//===----------------------------------------------------------------------===//
+//
+// 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 "RedundantTagCheck.h"
+
+#include "clang/AST/Decl.h"
+#include "clang/AST/DeclTemplate.h"
+#include "clang/AST/TypeLoc.h"
+#include "clang/ASTMatchers/ASTMatchFinder.h"
+#include "clang/ASTMatchers/ASTMatchers.h"
+#include "clang/Basic/Diagnostic.h"
+#include "clang/Lex/Lexer.h"
+
+using namespace clang::ast_matchers;
+
+namespace clang::tidy::readability {
+
+static bool canHideTag(const NamedDecl *D) {
+  D = D->getUnderlyingDecl();
+
+  return isa<VarDecl>(D) || isa<EnumConstantDecl>(D) || isa<FunctionDecl>(D) ||
+         isa<FunctionTemplateDecl>(D) || isa<FieldDecl>(D) ||
+         isa<UnresolvedUsingValueDecl>(D);
+}
+
+void RedundantTagCheck::registerMatchers(MatchFinder *Finder) {
+  Finder->addMatcher(
+      typeLoc(unless(hasAncestor(decl(isInstantiated())))).bind("typeLoc"),
+      this);
+}
+
+void RedundantTagCheck::check(const MatchFinder::MatchResult &Result) {
+  const auto *TL = Result.Nodes.getNodeAs<TypeLoc>("typeLoc");
+  if (!TL)
+    return;
+
+  if (TL->getType()->isInstantiationDependentType())
+    return;
+
+  const auto TagTL = TL->getAs<TagTypeLoc>();
+  if (!TagTL)
+    return;
+
+  const TagDecl *TD = TagTL.getDecl();
+  if (!TD)
+    return;
+
+  // Find the declaration enclosing this use of the tag.
+  const Decl *EnclosingDecl = nullptr;
+
+  DynTypedNodeList Parents = Result.Context->getParents(*TL);
+
+  while (!Parents.empty()) {
+    if (const auto *D = Parents[0].get<Decl>()) {
+      EnclosingDecl = D;
+      break;
+    }
+    Parents = Result.Context->getParents(Parents[0]);
+  }
+
+  if (!EnclosingDecl)
+    return;
+
+  const DeclarationName Name = TD->getDeclName();
+
+  for (const DeclContext *DC = EnclosingDecl->getDeclContext(); DC;
+       DC = DC->getLookupParent()) {
+    const auto Lookup = DC->lookup(Name);
+
+    if (Lookup.empty())
+      continue;
+
+    bool FoundSameEntity = false;
+
+    for (const NamedDecl *ND : Lookup) {
+      if (declaresSameEntity(ND, TD)) {
+        FoundSameEntity = true;
+        continue;
+      }
+
+      if (canHideTag(ND))
+        return;
+    }
+
+    if (FoundSameEntity)
+      break;
+  }
----------------
zwuis wrote:

https://llvm.org/docs/CodingStandards.html#turn-predicate-loops-into-predicate-functions

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


More information about the cfe-commits mailing list