13#include "clang/AST/CXXInheritance.h"
14#include "clang/Lex/PPCallbacks.h"
15#include "clang/Lex/Preprocessor.h"
16#include "llvm/ADT/ArrayRef.h"
17#include "llvm/ADT/StringRef.h"
18#include "llvm/Support/Debug.h"
19#include "llvm/Support/Path.h"
20#include "llvm/Support/Regex.h"
21#include "llvm/Support/YAMLParser.h"
24#define DEBUG_TYPE "clang-tidy"
33 std::pair<readability::IdentifierNamingCheck::CaseType, StringRef>>
49 "Leading_upper_snake_case"}};
55 readability::IdentifierNamingCheck::HungarianPrefixType> {
58 static llvm::ArrayRef<std::pair<HungarianPrefixType, StringRef>>
60 static constexpr std::pair<HungarianPrefixType, StringRef> Mapping[] = {
61 {HungarianPrefixType::HPT_Off,
"Off"},
62 {HungarianPrefixType::HPT_On,
"On"},
63 {HungarianPrefixType::HPT_LowerCase,
"LowerCase"},
64 {HungarianPrefixType::HPT_CamelCase,
"CamelCase"}};
69namespace readability {
72#define NAMING_KEYS(m) \
77 m(ScopedEnumConstant) \
78 m(ConstexprVariable) \
87 m(GlobalConstexprVariable) \
89 m(GlobalConstantPointer) \
92 m(LocalConstexprVariable) \
94 m(LocalConstantPointer) \
97 m(StaticConstexprVariable) \
102 m(ConstantParameter) \
105 m(PointerParameter) \
106 m(ConstantPointerParameter) \
113 m(ConstexprFunction) \
123 m(TypeTemplateParameter) \
124 m(ValueTemplateParameter) \
125 m(TemplateTemplateParameter) \
126 m(TemplateParameter) \
133#define ENUMERATE(v) SK_ ## v,
141#define STRINGIZE(v) #v,
146#define HUNGARIAN_NOTATION_PRIMITIVE_TYPES(m) \
170 m(signed-short-int) \
171 m(signed-long-long-int) \
172 m(signed-long-long) \
176 m(unsigned-long-long-int) \
177 m(unsigned-long-long) \
178 m(unsigned-long-int) \
180 m(unsigned-short-int) \
194#define STRINGIZE(v) #v,
199#define HUNGARIAN_NOTATION_USER_DEFINED_TYPES(m) \
230#define STRINGIZE(v) #v,
240 std::optional<IdentifierNamingCheck::CaseType> Case, StringRef Prefix,
241 StringRef Suffix, StringRef IgnoredRegexpStr, HungarianPrefixType HPType)
242 : Case(Case), Prefix(Prefix), Suffix(Suffix),
243 IgnoredRegexpStr(IgnoredRegexpStr), HPType(HPType) {
244 if (!IgnoredRegexpStr.empty()) {
245 IgnoredRegexp = llvm::Regex(SmallString<128>({
"^", IgnoredRegexpStr,
"$"}));
246 if (!IgnoredRegexp.isValid())
247 llvm::errs() <<
"Invalid IgnoredRegexp regular expression: "
253 const ClangTidyCheck::OptionsView &Options)
const {
261 SmallString<64> StyleString;
262 for (
unsigned I = 0; I <
SK_Count; ++I) {
263 const size_t StyleSize =
StyleNames[I].size();
264 StyleString.assign({
StyleNames[I],
"HungarianPrefix"});
269 configurationDiag(
"invalid identifier naming option '%0'") << StyleString;
271 memcpy(&StyleString[StyleSize],
"IgnoredRegexp", 13);
272 StyleString.truncate(StyleSize + 13);
273 const std::optional<StringRef> IgnoredRegexpStr = Options.get(StyleString);
274 memcpy(&StyleString[StyleSize],
"Prefix", 6);
275 StyleString.truncate(StyleSize + 6);
276 const std::optional<StringRef> Prefix(Options.get(StyleString));
278 memcpy(&StyleString[StyleSize],
"Suf", 3);
279 const std::optional<StringRef> Postfix(Options.get(StyleString));
280 memcpy(&StyleString[StyleSize],
"Case", 4);
281 StyleString.pop_back_n(2);
282 std::optional<CaseType> CaseOptional =
285 if (CaseOptional || Prefix || Postfix || IgnoredRegexpStr || HPTOpt)
286 Styles[I].emplace(std::move(CaseOptional), Prefix.value_or(
""),
287 Postfix.value_or(
""), IgnoredRegexpStr.value_or(
""),
290 const bool IgnoreMainLike = Options.get(
"IgnoreMainLikeFunctions",
false);
291 const bool CheckAnonFieldInParent =
292 Options.get(
"CheckAnonFieldInParent",
false);
293 return {std::move(Styles), std::move(HNOption), IgnoreMainLike,
294 CheckAnonFieldInParent};
298 const NamedDecl *ND)
const {
299 const auto *VD = dyn_cast<ValueDecl>(ND);
303 if (isa<FunctionDecl, EnumConstantDecl>(ND))
307 const auto &SM = VD->getASTContext().getSourceManager();
308 const char *Begin = SM.getCharacterData(VD->getBeginLoc());
309 const char *End = SM.getCharacterData(VD->getEndLoc());
310 intptr_t StrLen = End - Begin;
316 const char *EOL = strchr(Begin,
'\n');
318 EOL = Begin + strlen(Begin);
320 const char *
const PosList[] = {strchr(Begin,
'='), strchr(Begin,
';'),
321 strchr(Begin,
','), strchr(Begin,
')'), EOL};
322 for (
const auto &Pos : PosList)
324 EOL = std::min(EOL, Pos);
326 StrLen = EOL - Begin;
327 std::string TypeName;
329 std::string Type(Begin, StrLen);
331 static constexpr StringRef Keywords[] = {
333 "constexpr",
"constinit",
"consteval",
335 "const",
"volatile",
"restrict",
"mutable",
337 "register",
"static",
"extern",
"thread_local",
342 for (
const StringRef Kw : Keywords)
343 for (
size_t Pos = 0; (Pos = Type.find(Kw, Pos)) != std::string::npos;)
344 Type.replace(Pos, Kw.size(),
"");
345 TypeName = Type.erase(0, Type.find_first_not_of(
' '));
348 const size_t Pos = Type.find(
'<');
349 if (Pos != std::string::npos)
350 TypeName = Type.erase(Pos, Type.size() - Pos);
353 for (
size_t Pos = 0; (Pos = Type.find(
" ", Pos)) != std::string::npos;
354 Pos += strlen(
" ")) {
355 Type.replace(Pos, strlen(
" "),
" ");
359 for (
size_t Pos = 0; (Pos = Type.find(
" &", Pos)) != std::string::npos;
360 Pos += strlen(
"&")) {
361 Type.replace(Pos, strlen(
" &"),
"&");
365 for (
size_t Pos = 0; (Pos = Type.find(
" *", Pos)) != std::string::npos;
366 Pos += strlen(
"*")) {
367 Type.replace(Pos, strlen(
" *"),
"* ");
371 static constexpr StringRef TailsOfMultiWordType[] = {
372 " int",
" char",
" double",
" long",
" short"};
373 bool RedundantRemoved =
false;
374 for (
auto Kw : TailsOfMultiWordType) {
375 const size_t Pos = Type.rfind(Kw);
376 if (Pos != std::string::npos) {
378 Type = Type.substr(0, Pos + Kw.size() + PtrCount);
379 RedundantRemoved =
true;
384 TypeName = Type.erase(0, Type.find_first_not_of(
' '));
385 if (!RedundantRemoved) {
386 const std::size_t FoundSpace = Type.find(
' ');
387 if (FoundSpace != std::string::npos)
388 Type = Type.substr(0, FoundSpace);
391 TypeName = Type.erase(0, Type.find_first_not_of(
' '));
393 const QualType QT = VD->getType();
394 if (!QT.isNull() && QT->isArrayType())
395 TypeName.append(
"[]");
404 GetConfigPerFile(Options.get(
"GetConfigPerFile", true)),
405 IgnoreFailedSplit(Options.get(
"IgnoreFailedSplit", false)) {
406 const auto IterAndInserted = NamingStylesCache.try_emplace(
407 llvm::sys::path::parent_path(Context->getCurrentFile()),
409 assert(IterAndInserted.second &&
"Couldn't insert Style");
412 MainFileStyle = &IterAndInserted.first->getValue();
418 int StyleKindIndex)
const {
419 if (StyleKindIndex == SK_Default)
422 if ((StyleKindIndex >= SK_EnumConstant) &&
423 (StyleKindIndex <= SK_ConstantParameter))
426 if ((StyleKindIndex >= SK_Parameter) && (StyleKindIndex <= SK_Enum))
433 StringRef OptionKey,
const llvm::StringMap<std::string> &StrMap)
const {
434 if (OptionKey.empty())
437 const auto Iter = StrMap.find(OptionKey);
438 if (Iter == StrMap.end())
441 return llvm::yaml::parseBool(Iter->getValue()).value_or(
false);
445 const ClangTidyCheck::OptionsView &Options,
447 static constexpr StringRef HNOpts[] = {
"TreatStructAsClass"};
448 static constexpr StringRef HNDerivedTypes[] = {
"Array",
"Pointer",
451 const StringRef Section =
"HungarianNotation.";
453 SmallString<128> Buffer = {Section,
"General."};
454 size_t DefSize = Buffer.size();
455 for (
const auto &Opt : HNOpts) {
456 Buffer.truncate(DefSize);
458 const StringRef Val = Options.get(Buffer,
"");
460 HNOption.
General[Opt] = Val.str();
463 Buffer = {Section,
"DerivedType."};
464 DefSize = Buffer.size();
465 for (
const auto &Type : HNDerivedTypes) {
466 Buffer.truncate(DefSize);
468 const StringRef Val = Options.get(Buffer,
"");
473 static constexpr std::pair<StringRef, StringRef> HNCStrings[] = {
474 {
"CharPointer",
"char*"},
475 {
"CharArray",
"char[]"},
476 {
"WideCharPointer",
"wchar_t*"},
477 {
"WideCharArray",
"wchar_t[]"}};
479 Buffer = {Section,
"CString."};
480 DefSize = Buffer.size();
481 for (
const auto &CStr : HNCStrings) {
482 Buffer.truncate(DefSize);
483 Buffer.append(CStr.first);
484 const StringRef Val = Options.get(Buffer,
"");
486 HNOption.
CString[CStr.second] = Val.str();
489 Buffer = {Section,
"PrimitiveType."};
490 DefSize = Buffer.size();
492 Buffer.truncate(DefSize);
493 Buffer.append(PrimType);
494 const StringRef Val = Options.get(Buffer,
"");
496 std::string Type = PrimType.str();
497 llvm::replace(Type,
'-',
' ');
502 Buffer = {Section,
"UserDefinedType."};
503 DefSize = Buffer.size();
505 Buffer.truncate(DefSize);
507 const StringRef Val = Options.get(Buffer,
"");
518 const auto *ND = dyn_cast<NamedDecl>(D);
523 if (
const auto *ECD = dyn_cast<EnumConstantDecl>(ND)) {
525 }
else if (
const auto *CRD = dyn_cast<CXXRecordDecl>(ND)) {
527 }
else if (isa<VarDecl, FieldDecl, RecordDecl>(ND)) {
529 if (!TypeName.empty())
539 if (Words.size() <= 1)
542 const std::string CorrectName = Words[0].str();
543 const std::vector<llvm::StringMap<std::string>> MapList = {
547 for (
const auto &Map : MapList) {
548 for (
const auto &Str : Map) {
549 if (Str.getValue() == CorrectName) {
550 Words.erase(Words.begin(), Words.begin() + 1);
560 StringRef TypeName,
const NamedDecl *ND,
562 if (!ND || TypeName.empty())
563 return TypeName.str();
565 std::string ModifiedTypeName(TypeName);
568 std::string PrefixStr;
569 if (
const auto *TD = dyn_cast<ValueDecl>(ND)) {
570 const QualType QT = TD->getType();
571 if (QT->isFunctionPointerType()) {
572 PrefixStr = HNOption.
DerivedType.lookup(
"FunctionPointer");
573 }
else if (QT->isPointerType()) {
574 for (
const auto &CStr : HNOption.
CString) {
575 const std::string Key = CStr.getKey().str();
576 if (ModifiedTypeName.find(Key) == 0) {
577 PrefixStr = CStr.getValue();
578 ModifiedTypeName = ModifiedTypeName.substr(
579 Key.size(), ModifiedTypeName.size() - Key.size());
583 }
else if (QT->isArrayType()) {
584 for (
const auto &CStr : HNOption.
CString) {
585 const std::string Key = CStr.getKey().str();
586 if (ModifiedTypeName.find(Key) == 0) {
587 PrefixStr = CStr.getValue();
591 if (PrefixStr.empty())
593 }
else if (QT->isReferenceType()) {
594 const size_t Pos = ModifiedTypeName.find_last_of(
'&');
595 if (Pos != std::string::npos)
596 ModifiedTypeName = ModifiedTypeName.substr(0, Pos);
603 ModifiedTypeName = [&](std::string Str, StringRef From, StringRef To) {
605 while ((StartPos = Str.find(From, StartPos)) != std::string::npos) {
606 Str.replace(StartPos, From.size(), To);
607 StartPos += To.size();
610 }(ModifiedTypeName,
"*",
"");
614 if (PrefixStr.empty()) {
616 if (ModifiedTypeName == Type.getKey()) {
617 PrefixStr = Type.getValue();
624 if (PrefixStr.empty()) {
626 if (ModifiedTypeName == Type.getKey()) {
627 PrefixStr = Type.getValue();
633 for (
size_t Idx = 0; Idx < PtrCount; Idx++)
634 PrefixStr.insert(0, HNOption.
DerivedType.lookup(
"Pointer"));
640 const CXXRecordDecl *CRD,
645 if (CRD->isStruct() &&
649 return CRD->hasDefinition() && CRD->isAbstract() ?
"I" :
"C";
653 const EnumConstantDecl *ECD)
const {
654 const auto *ED = cast<EnumDecl>(ECD->getDeclContext());
656 std::string Name = ED->getName().str();
657 if (StringRef(Name).contains(
"enum")) {
658 Name = Name.substr(strlen(
"enum"), Name.length() - strlen(
"enum"));
659 Name = Name.erase(0, Name.find_first_not_of(
' '));
662 static const llvm::Regex Splitter(
663 "([a-z0-9A-Z]*)(_+)|([A-Z]?[a-z0-9]+)([A-Z]|$)|([A-Z]+)([A-Z]|$)");
665 const StringRef EnumName(Name);
667 EnumName.split(Substrs,
"_", -1,
false);
671 for (
auto Substr : Substrs) {
672 while (!Substr.empty()) {
674 if (!Splitter.match(Substr, &Groups))
677 if (!Groups[2].empty()) {
678 Words.push_back(Groups[1]);
679 Substr = Substr.substr(Groups[0].size());
680 }
else if (!Groups[3].empty()) {
681 Words.push_back(Groups[3]);
682 Substr = Substr.substr(Groups[0].size() - Groups[4].size());
683 }
else if (!Groups[5].empty()) {
684 Words.push_back(Groups[5]);
685 Substr = Substr.substr(Groups[0].size() - Groups[6].size());
691 for (
const StringRef Word : Words)
692 Initial += tolower(Word[0]);
698 const std::string &TypeName)
const {
699 size_t Pos = TypeName.find(
'*');
701 for (; Pos < TypeName.length(); Pos++, Count++)
702 if (
'*' != TypeName[Pos])
708 const std::string &TypeName,
const NamedDecl *ND)
const {
710 if (
const auto *TD = dyn_cast<ValueDecl>(ND)) {
711 const QualType QT = TD->getType();
712 if (QT->isPointerType())
721 static constexpr std::pair<StringRef, StringRef> General[] = {
722 {
"TreatStructAsClass",
"false"}};
723 for (
const auto &G : General)
724 HNOption.
General.try_emplace(G.first, G.second);
727 static constexpr std::pair<StringRef, StringRef> DerivedTypes[] = {
728 {
"Array",
"a"}, {
"Pointer",
"p"}, {
"FunctionPointer",
"fn"}};
729 for (
const auto &DT : DerivedTypes)
730 HNOption.
DerivedType.try_emplace(DT.first, DT.second);
733 static constexpr std::pair<StringRef, StringRef> CStrings[] = {
737 {
"wchar_t[]",
"wsz"}};
738 for (
const auto &CStr : CStrings)
739 HNOption.
CString.try_emplace(CStr.first, CStr.second);
742 static constexpr std::pair<StringRef, StringRef> PrimitiveTypes[] = {
748 {
"uint16_t",
"u16" },
749 {
"uint32_t",
"u32" },
750 {
"uint64_t",
"u64" },
752 {
"char16_t",
"c16" },
753 {
"char32_t",
"c32" },
762 {
"short int",
"si" },
764 {
"signed int",
"si" },
765 {
"signed short",
"ss" },
766 {
"signed short int",
"ssi" },
767 {
"signed long long int",
"slli"},
768 {
"signed long long",
"sll" },
769 {
"signed long int",
"sli" },
770 {
"signed long",
"sl" },
772 {
"unsigned long long int",
"ulli"},
773 {
"unsigned long long",
"ull" },
774 {
"unsigned long int",
"uli" },
775 {
"unsigned long",
"ul" },
776 {
"unsigned short int",
"usi" },
777 {
"unsigned short",
"us" },
778 {
"unsigned int",
"ui" },
779 {
"unsigned char",
"uc" },
781 {
"long long int",
"lli" },
782 {
"long double",
"ld" },
783 {
"long long",
"ll" },
789 for (
const auto &PT : PrimitiveTypes)
793 static constexpr std::pair<StringRef, StringRef> UserDefinedTypes[] = {
810 {
"ULONGLONG",
"ull" },
824 for (
const auto &UDT : UserDefinedTypes)
830 SmallString<64> StyleString;
831 const ArrayRef<std::optional<NamingStyle>> Styles =
832 MainFileStyle->getStyles();
833 for (
size_t I = 0; I <
SK_Count; ++I) {
834 const auto &StyleOpt = Styles[I];
838 const size_t StyleSize =
StyleNames[I].size();
839 StyleString.assign({
StyleNames[I],
"HungarianPrefix"});
841 Options.store(Opts, StyleString, Style.HPType);
843 memcpy(&StyleString[StyleSize],
"IgnoredRegexp", 13);
844 StyleString.truncate(StyleSize + 13);
845 Options.store(Opts, StyleString, Style.IgnoredRegexpStr);
846 memcpy(&StyleString[StyleSize],
"Prefix", 6);
847 StyleString.truncate(StyleSize + 6);
848 Options.store(Opts, StyleString, Style.Prefix);
850 memcpy(&StyleString[StyleSize],
"Suf", 3);
851 Options.store(Opts, StyleString, Style.Suffix);
853 memcpy(&StyleString[StyleSize],
"Case", 4);
854 StyleString.pop_back_n(2);
855 Options.store(Opts, StyleString, *Style.Case);
858 Options.store(Opts,
"GetConfigPerFile", GetConfigPerFile);
859 Options.store(Opts,
"IgnoreFailedSplit", IgnoreFailedSplit);
860 Options.store(Opts,
"IgnoreMainLikeFunctions",
861 MainFileStyle->isIgnoringMainLikeFunction());
862 Options.store(Opts,
"CheckAnonFieldInParent",
863 MainFileStyle->isCheckingAnonFieldInParentScope());
867 StringRef Type, StringRef Name,
870 const NamedDecl *Decl)
const {
871 static const llvm::Regex Matchers[] = {
873 llvm::Regex(
"^[a-z][a-z0-9_]*$"),
874 llvm::Regex(
"^[a-z][a-zA-Z0-9]*$"),
875 llvm::Regex(
"^[A-Z][A-Z0-9_]*$"),
876 llvm::Regex(
"^[A-Z][a-zA-Z0-9]*$"),
877 llvm::Regex(
"^[A-Z]+([a-z0-9]*_[A-Z0-9]+)*[a-z0-9]*$"),
878 llvm::Regex(
"^[a-z]+([a-z0-9]*_[A-Z0-9]+)*[a-z0-9]*$"),
879 llvm::Regex(
"^[A-Z]([a-z0-9_]*[a-z])*$"),
882 if (!Name.consume_front(Style.Prefix))
884 if (!Name.consume_back(Style.Suffix))
888 if (!HNPrefix.empty()) {
889 if (!Name.consume_front(HNPrefix))
893 !Name.consume_front(
"_"))
900 if (Name.starts_with(
'_') || Name.ends_with(
'_'))
903 if (Style.Case && !Matchers[
static_cast<size_t>(*Style.Case)].match(Name))
910 StringRef Type, StringRef Name,
const Decl *D,
914 static const llvm::Regex Splitter(
915 "([a-z0-9A-Z]*)(_+)|([A-Z]?[a-z0-9]+)([A-Z]|$)|([A-Z]+)([A-Z]|$)");
918 Name.split(Substrs,
"_", -1,
false);
922 for (
auto Substr : Substrs) {
923 while (!Substr.empty()) {
925 if (!Splitter.match(Substr, &Groups))
928 if (!Groups[2].empty()) {
929 Words.push_back(Groups[1]);
930 Substr = Substr.substr(Groups[0].size());
931 }
else if (!Groups[3].empty()) {
932 Words.push_back(Groups[3]);
933 Substr = Substr.substr(Groups[0].size() - Groups[4].size());
934 }
else if (!Groups[5].empty()) {
935 Words.push_back(Groups[5]);
936 Substr = Substr.substr(Groups[0].size() - Groups[6].size());
947 SmallString<128> Fixup;
954 for (
const auto &Word : Words) {
955 if (&Word != &Words.front())
957 Fixup += Word.lower();
962 for (
const auto &Word : Words) {
963 if (&Word != &Words.front())
965 Fixup += Word.upper();
970 for (
const auto &Word : Words) {
971 Fixup += toupper(Word.front());
972 Fixup += Word.substr(1).lower();
977 for (
const auto &Word : Words) {
978 if (&Word == &Words.front()) {
979 Fixup += Word.lower();
981 Fixup += toupper(Word.front());
982 Fixup += Word.substr(1).lower();
988 for (
const auto &Word : Words) {
989 if (&Word != &Words.front())
991 Fixup += toupper(Word.front());
992 Fixup += Word.substr(1).lower();
997 for (
const auto &Word : Words) {
998 if (&Word != &Words.front()) {
1000 Fixup += toupper(Word.front());
1002 Fixup += tolower(Word.front());
1004 Fixup += Word.substr(1).lower();
1009 for (
const auto &Word : Words) {
1010 if (&Word != &Words.front()) {
1012 Fixup += Word.lower();
1014 Fixup += toupper(Word.front());
1015 Fixup += Word.substr(1).lower();
1021 return Fixup.str().str();
1025 const ParmVarDecl &ParmDecl,
bool IncludeMainLike)
const {
1027 dyn_cast_or_null<FunctionDecl>(ParmDecl.getParentFunctionOrMethod());
1030 if (FDecl->isMain())
1032 if (!IncludeMainLike)
1034 if (FDecl->getAccess() != AS_public && FDecl->getAccess() != AS_none)
1038 if (!FDecl->getDeclName().isIdentifier())
1040 enum MainType { None, Main, WMain };
1041 const auto IsCharPtrPtr = [](QualType QType) -> MainType {
1044 if (QType = QType->getPointeeType(), QType.isNull())
1046 if (QType = QType->getPointeeType(), QType.isNull())
1048 if (QType->isCharType())
1050 if (QType->isWideCharType())
1054 const auto IsIntType = [](QualType QType) {
1057 if (
const auto *Builtin =
1058 dyn_cast<BuiltinType>(QType->getUnqualifiedDesugaredType())) {
1059 return Builtin->getKind() == BuiltinType::Int;
1063 if (!IsIntType(FDecl->getReturnType()))
1065 if (FDecl->getNumParams() < 2 || FDecl->getNumParams() > 3)
1067 if (!IsIntType(FDecl->parameters()[0]->getType()))
1069 const MainType Type = IsCharPtrPtr(FDecl->parameters()[1]->getType());
1072 if (FDecl->getNumParams() == 3 &&
1073 IsCharPtrPtr(FDecl->parameters()[2]->getType()) != Type)
1077 static const llvm::Regex Matcher(
1078 "(^[Mm]ain([_A-Z]|$))|([a-z0-9_]Main([_A-Z]|$))|(_main(_|$))");
1079 assert(Matcher.isValid() &&
"Invalid Matcher for main like functions.");
1080 return Matcher.match(FDecl->getName());
1082 static const llvm::Regex Matcher(
1083 "(^((W[Mm])|(wm))ain([_A-Z]|$))|([a-z0-9_]W[Mm]"
1084 "ain([_A-Z]|$))|(_wmain(_|$))");
1085 assert(Matcher.isValid() &&
"Invalid Matcher for wmain like functions.");
1086 return Matcher.match(FDecl->getName());
1090 StringRef Type, StringRef Name,
1093 const Decl *D)
const {
1094 Name.consume_front(Style.Prefix);
1095 Name.consume_back(Style.Suffix);
1097 Type, Name, D, Style, HNOption,
1100 std::string HungarianPrefix;
1104 if (!HungarianPrefix.empty()) {
1106 HungarianPrefix +=
'_';
1109 Fixed[0] = toupper(Fixed[0]);
1112 StringRef Mid = StringRef(Fixed).trim(
"_");
1116 return (Style.Prefix + HungarianPrefix + Mid + Style.Suffix).str();
1121 ArrayRef<std::optional<IdentifierNamingCheck::NamingStyle>> NamingStyles,
1122 bool IgnoreMainLikeFunctions,
bool CheckAnonFieldInParentScope)
const {
1123 assert(D && D->getIdentifier() && !D->getName().empty() && !D->isImplicit() &&
1124 "Decl must be an explicit identifier with a name.");
1126 if (isa<ObjCIvarDecl>(D) && NamingStyles[SK_ObjcIvar])
1129 if (isa<TypedefDecl>(D) && NamingStyles[SK_Typedef])
1132 if (isa<TypeAliasDecl>(D) && NamingStyles[SK_TypeAlias])
1133 return SK_TypeAlias;
1135 if (isa<NamespaceAliasDecl>(D) && NamingStyles[SK_Namespace])
1136 return SK_Namespace;
1138 if (
const auto *Decl = dyn_cast<NamespaceDecl>(D)) {
1139 if (Decl->isAnonymousNamespace())
1142 if (Decl->isInline() && NamingStyles[SK_InlineNamespace])
1143 return SK_InlineNamespace;
1145 if (NamingStyles[SK_Namespace])
1146 return SK_Namespace;
1149 if (isa<EnumDecl>(D) && NamingStyles[SK_Enum])
1152 if (
const auto *EnumConst = dyn_cast<EnumConstantDecl>(D)) {
1153 if (cast<EnumDecl>(EnumConst->getDeclContext())->isScoped() &&
1154 NamingStyles[SK_ScopedEnumConstant])
1155 return SK_ScopedEnumConstant;
1157 if (NamingStyles[SK_EnumConstant])
1158 return SK_EnumConstant;
1160 if (NamingStyles[SK_Constant])
1163 return undefinedStyle(NamingStyles);
1166 if (
const auto *Decl = dyn_cast<RecordDecl>(D)) {
1167 if (Decl->isAnonymousStructOrUnion())
1170 if (
const auto *Definition = Decl->getDefinition()) {
1171 if (
const auto *CxxRecordDecl = dyn_cast<CXXRecordDecl>(Definition)) {
1172 if (CxxRecordDecl->isAbstract() && NamingStyles[SK_AbstractClass])
1173 return SK_AbstractClass;
1176 if (Definition->isStruct() && NamingStyles[SK_Struct])
1179 if (Definition->isStruct() && NamingStyles[SK_Class])
1182 if (Definition->isClass() && NamingStyles[SK_Class])
1185 if (Definition->isClass() && NamingStyles[SK_Struct])
1188 if (Definition->isUnion() && NamingStyles[SK_Union])
1191 if (Definition->isEnum() && NamingStyles[SK_Enum])
1195 return undefinedStyle(NamingStyles);
1198 if (
const auto *Decl = dyn_cast<FieldDecl>(D)) {
1199 if (CheckAnonFieldInParentScope) {
1200 const RecordDecl *Record = Decl->getParent();
1201 if (Record->isAnonymousStructOrUnion())
1202 return findStyleKindForAnonField(Decl, NamingStyles);
1205 return findStyleKindForField(Decl, Decl->getType(), NamingStyles);
1208 if (
const auto *Decl = dyn_cast<ParmVarDecl>(D)) {
1211 const QualType Type = Decl->getType();
1213 if (Decl->isConstexpr() && NamingStyles[SK_ConstexprVariable])
1214 return SK_ConstexprVariable;
1216 if (!Type.isNull() && Type.isConstQualified()) {
1217 if (Type.getTypePtr()->isAnyPointerType() &&
1218 NamingStyles[SK_ConstantPointerParameter])
1219 return SK_ConstantPointerParameter;
1221 if (NamingStyles[SK_ConstantParameter])
1222 return SK_ConstantParameter;
1224 if (NamingStyles[SK_Constant])
1228 if (Decl->isParameterPack() && NamingStyles[SK_ParameterPack])
1229 return SK_ParameterPack;
1231 if (!Type.isNull() && Type.getTypePtr()->isAnyPointerType() &&
1232 NamingStyles[SK_PointerParameter])
1233 return SK_PointerParameter;
1235 if (NamingStyles[SK_Parameter])
1236 return SK_Parameter;
1238 return undefinedStyle(NamingStyles);
1241 if (
const auto *Decl = dyn_cast<VarDecl>(D))
1242 return findStyleKindForVar(Decl, Decl->getType(), NamingStyles);
1246 if (
const auto *BD = dyn_cast<BindingDecl>(D)) {
1247 if (
const auto *Decomp = dyn_cast_or_null<VarDecl>(BD->getDecomposedDecl());
1248 Decomp && !BD->getType().isNull())
1249 return findStyleKindForVar(Decomp, BD->getType(), NamingStyles);
1253 if (
const auto *Decl = dyn_cast<CXXMethodDecl>(D)) {
1254 if (Decl->isMain() || !Decl->isUserProvided() ||
1255 Decl->size_overridden_methods() > 0 || Decl->hasAttr<OverrideAttr>())
1260 for (
const CXXBaseSpecifier &Base : Decl->getParent()->bases())
1261 if (
const auto *RD = Base.getType()->getAsCXXRecordDecl();
1262 RD && RD->hasMemberName(Decl->getDeclName()))
1265 if (Decl->isConstexpr() && NamingStyles[SK_ConstexprMethod])
1266 return SK_ConstexprMethod;
1268 if (Decl->isConstexpr() && NamingStyles[SK_ConstexprFunction])
1269 return SK_ConstexprFunction;
1271 if (Decl->isStatic() && NamingStyles[SK_ClassMethod])
1272 return SK_ClassMethod;
1274 if (Decl->isVirtual() && NamingStyles[SK_VirtualMethod])
1275 return SK_VirtualMethod;
1277 if (Decl->getAccess() == AS_private && NamingStyles[SK_PrivateMethod])
1278 return SK_PrivateMethod;
1280 if (Decl->getAccess() == AS_protected && NamingStyles[SK_ProtectedMethod])
1281 return SK_ProtectedMethod;
1283 if (Decl->getAccess() == AS_public && NamingStyles[SK_PublicMethod])
1284 return SK_PublicMethod;
1286 if (NamingStyles[SK_Method])
1289 if (NamingStyles[SK_Function])
1292 return undefinedStyle(NamingStyles);
1295 if (
const auto *Decl = dyn_cast<FunctionDecl>(D)) {
1299 if (Decl->isConstexpr() && NamingStyles[SK_ConstexprFunction])
1300 return SK_ConstexprFunction;
1302 if (Decl->isGlobal() && NamingStyles[SK_GlobalFunction])
1303 return SK_GlobalFunction;
1305 if (NamingStyles[SK_Function])
1312 if (isa<FunctionTemplateDecl, ClassTemplateDecl, VarTemplateDecl,
1313 TypeAliasTemplateDecl>(D))
1316 if (isa<TemplateTypeParmDecl>(D)) {
1317 if (NamingStyles[SK_TypeTemplateParameter])
1318 return SK_TypeTemplateParameter;
1320 if (NamingStyles[SK_TemplateParameter])
1321 return SK_TemplateParameter;
1323 return undefinedStyle(NamingStyles);
1326 if (isa<NonTypeTemplateParmDecl>(D)) {
1327 if (NamingStyles[SK_ValueTemplateParameter])
1328 return SK_ValueTemplateParameter;
1330 if (NamingStyles[SK_TemplateParameter])
1331 return SK_TemplateParameter;
1333 return undefinedStyle(NamingStyles);
1336 if (isa<TemplateTemplateParmDecl>(D)) {
1337 if (NamingStyles[SK_TemplateTemplateParameter])
1338 return SK_TemplateTemplateParameter;
1340 if (NamingStyles[SK_TemplateParameter])
1341 return SK_TemplateParameter;
1343 return undefinedStyle(NamingStyles);
1346 if (isa<ConceptDecl>(D) && NamingStyles[SK_Concept])
1349 return undefinedStyle(NamingStyles);
1352std::optional<RenamerClangTidyCheck::FailureInfo>
1354 StringRef Type, StringRef Name,
const NamedDecl *ND,
1356 ArrayRef<std::optional<IdentifierNamingCheck::NamingStyle>> NamingStyles,
1358 StyleKind SK,
const SourceManager &SM,
bool IgnoreFailedSplit)
const {
1360 return std::nullopt;
1362 const auto &StyleOpt = NamingStyles[SK];
1364 return std::nullopt;
1367 if (Style.IgnoredRegexp.isValid() && Style.IgnoredRegexp.match(Name))
1368 return std::nullopt;
1371 return std::nullopt;
1373 std::string KindName =
1378 llvm::replace(KindName,
'_',
' ');
1380 std::string Fixup =
fixupWithStyle(Type, Name, Style, HNOption, ND);
1381 if (StringRef(Fixup) == Name) {
1382 if (!IgnoreFailedSplit) {
1383 LLVM_DEBUG(
Location.print(llvm::dbgs(), SM);
1384 llvm::dbgs() <<
": unable to split words for " << KindName
1385 <<
" '" << Name <<
"'\n");
1387 return std::nullopt;
1393std::optional<RenamerClangTidyCheck::FailureInfo>
1394IdentifierNamingCheck::getDeclFailureInfo(
const NamedDecl *Decl,
1395 const SourceManager &SM)
const {
1397 if (Decl->isImplicit())
1398 return std::nullopt;
1400 const SourceLocation Loc = Decl->getLocation();
1401 const SourceLocation SpellingLoc = SM.getSpellingLoc(Loc);
1402 const FileStyle &FileStyle = getStyleForFile(SM.getFilename(SpellingLoc));
1403 if (!FileStyle.isActive())
1404 return std::nullopt;
1408 FileStyle.getStyles(), FileStyle.getHNOption(),
1410 FileStyle.isIgnoringMainLikeFunction(),
1411 FileStyle.isCheckingAnonFieldInParentScope()),
1412 SM, IgnoreFailedSplit);
1415std::optional<RenamerClangTidyCheck::FailureInfo>
1416IdentifierNamingCheck::getMacroFailureInfo(
const Token &MacroNameTok,
1417 const SourceManager &SM)
const {
1418 const SourceLocation Loc = MacroNameTok.getLocation();
1419 const FileStyle &Style = getStyleForFile(SM.getFilename(Loc));
1420 if (!Style.isActive())
1421 return std::nullopt;
1423 const auto &Styles = Style.getStyles();
1424 const StyleKind UsedKind = !Styles[SK_MacroDefinition] && Styles[SK_Default]
1426 : SK_MacroDefinition;
1428 return getFailureInfo(
"", MacroNameTok.getIdentifierInfo()->getName(),
1429 nullptr, Loc, Style.getStyles(), Style.getHNOption(),
1430 UsedKind, SM, IgnoreFailedSplit);
1433RenamerClangTidyCheck::DiagInfo
1435 const NamingCheckFailure &Failure)
const {
1436 return DiagInfo{
"invalid case style for %0 '%1'",
1437 [&](DiagnosticBuilder &Diag) {
1438 Diag << Failure.Info.KindName << ID.second;
1442StringRef IdentifierNamingCheck::getRealFileName(StringRef FileName)
const {
1443 const auto Iter = RealFileNameCache.try_emplace(FileName);
1444 SmallString<256U> &RealFileName = Iter.first->getValue();
1446 return RealFileName;
1447 llvm::sys::fs::real_path(FileName, RealFileName);
1448 return RealFileName;
1451const IdentifierNamingCheck::FileStyle &
1452IdentifierNamingCheck::getStyleForFile(StringRef FileName)
const {
1453 if (!GetConfigPerFile)
1454 return *MainFileStyle;
1456 const StringRef RealFileName = getRealFileName(FileName);
1457 const StringRef Parent = llvm::sys::path::parent_path(RealFileName);
1458 const auto Iter = NamingStylesCache.find(Parent);
1459 if (Iter != NamingStylesCache.end())
1460 return Iter->getValue();
1462 const StringRef CheckName = getID();
1463 ClangTidyOptions Options = Context->getOptionsForFile(RealFileName);
1464 if (Options.
Checks && GlobList(*Options.
Checks).contains(CheckName)) {
1465 const auto It = NamingStylesCache.try_emplace(
1469 return It.first->getValue();
1472 const auto It = NamingStylesCache.try_emplace(Parent);
1474 return It.first->getValue();
1477StyleKind IdentifierNamingCheck::findStyleKindForAnonField(
1478 const FieldDecl *AnonField,
1479 ArrayRef<std::optional<NamingStyle>> NamingStyles)
const {
1480 const IndirectFieldDecl *IFD =
1482 assert(IFD &&
"Found an anonymous record field without an IndirectFieldDecl");
1484 const QualType
Type = AnonField->getType();
1486 if (
const auto *F = dyn_cast<FieldDecl>(IFD->chain().front()))
1487 return findStyleKindForField(F, Type, NamingStyles);
1489 if (
const auto *V = IFD->getVarDecl())
1490 return findStyleKindForVar(V, Type, NamingStyles);
1492 return undefinedStyle(NamingStyles);
1495StyleKind IdentifierNamingCheck::findStyleKindForField(
1496 const FieldDecl *Field, QualType Type,
1497 ArrayRef<std::optional<NamingStyle>> NamingStyles)
const {
1498 if (!
Type.isNull() &&
Type.isConstQualified()) {
1499 if (NamingStyles[SK_ConstantMember])
1500 return SK_ConstantMember;
1502 if (NamingStyles[SK_Constant])
1506 if (
Field->getAccess() == AS_private && NamingStyles[SK_PrivateMember])
1507 return SK_PrivateMember;
1509 if (
Field->getAccess() == AS_protected && NamingStyles[SK_ProtectedMember])
1510 return SK_ProtectedMember;
1512 if (
Field->getAccess() == AS_public && NamingStyles[SK_PublicMember])
1513 return SK_PublicMember;
1515 if (NamingStyles[SK_Member])
1518 return undefinedStyle(NamingStyles);
1521StyleKind IdentifierNamingCheck::findStyleKindForVar(
1522 const VarDecl *Var, QualType Type,
1523 ArrayRef<std::optional<NamingStyle>> NamingStyles)
const {
1524 if (Var->isConstexpr()) {
1525 if (Var->isStaticDataMember() && NamingStyles[SK_ClassConstexpr])
1526 return SK_ClassConstexpr;
1528 if (Var->isFileVarDecl() && NamingStyles[SK_GlobalConstexprVariable])
1529 return SK_GlobalConstexprVariable;
1531 if (Var->isStaticLocal() && NamingStyles[SK_StaticConstexprVariable])
1532 return SK_StaticConstexprVariable;
1534 if (Var->isLocalVarDecl() && NamingStyles[SK_LocalConstexprVariable])
1535 return SK_LocalConstexprVariable;
1537 if (NamingStyles[SK_ConstexprVariable])
1538 return SK_ConstexprVariable;
1541 if (!
Type.isNull() &&
Type.isConstQualified()) {
1542 if (Var->isStaticDataMember() && NamingStyles[SK_ClassConstant])
1543 return SK_ClassConstant;
1545 if (Var->isFileVarDecl() &&
Type.getTypePtr()->isAnyPointerType() &&
1546 NamingStyles[SK_GlobalConstantPointer])
1547 return SK_GlobalConstantPointer;
1549 if (Var->isFileVarDecl() && NamingStyles[SK_GlobalConstant])
1550 return SK_GlobalConstant;
1552 if (Var->isStaticLocal() && NamingStyles[SK_StaticConstant])
1553 return SK_StaticConstant;
1555 if (Var->isLocalVarDecl() &&
Type.getTypePtr()->isAnyPointerType() &&
1556 NamingStyles[SK_LocalConstantPointer])
1557 return SK_LocalConstantPointer;
1559 if (Var->isLocalVarDecl() && NamingStyles[SK_LocalConstant])
1560 return SK_LocalConstant;
1562 if (Var->isFunctionOrMethodVarDecl() && NamingStyles[SK_LocalConstant])
1563 return SK_LocalConstant;
1565 if (NamingStyles[SK_Constant])
1569 if (Var->isStaticDataMember() && NamingStyles[SK_ClassMember])
1570 return SK_ClassMember;
1572 if (Var->isFileVarDecl() &&
Type.getTypePtr()->isAnyPointerType() &&
1573 NamingStyles[SK_GlobalPointer])
1574 return SK_GlobalPointer;
1576 if (Var->isFileVarDecl() && NamingStyles[SK_GlobalVariable])
1577 return SK_GlobalVariable;
1579 if (Var->isStaticLocal() && NamingStyles[SK_StaticVariable])
1580 return SK_StaticVariable;
1582 if (Var->isLocalVarDecl() &&
Type.getTypePtr()->isAnyPointerType() &&
1583 NamingStyles[SK_LocalPointer])
1584 return SK_LocalPointer;
1586 if (Var->isLocalVarDecl() && NamingStyles[SK_LocalVariable])
1587 return SK_LocalVariable;
1589 if (Var->isFunctionOrMethodVarDecl() && NamingStyles[SK_LocalVariable])
1590 return SK_LocalVariable;
1592 if (NamingStyles[SK_Variable])
1595 return undefinedStyle(NamingStyles);
1598StyleKind IdentifierNamingCheck::undefinedStyle(
1599 ArrayRef<std::optional<NamingStyle>> NamingStyles)
const {
1600 return NamingStyles[SK_Default] ? SK_Default :
SK_Invalid;
#define HUNGARIAN_NOTATION_PRIMITIVE_TYPES(m)
#define HUNGARIAN_NOTATION_USER_DEFINED_TYPES(m)
Every ClangTidyCheck reports errors through a DiagnosticsEngine provided by this context.
std::pair< SourceLocation, StringRef > NamingCheckId
RenamerClangTidyCheck(StringRef CheckName, ClangTidyContext *Context)
void storeOptions(ClangTidyOptions::OptionMap &Opts) override
Derived classes that override this function should call this method from the overridden method.
IdentifierNamingCheck(StringRef Name, ClangTidyContext *Context)
std::string fixupWithCase(StringRef Type, StringRef Name, const Decl *D, const IdentifierNamingCheck::NamingStyle &Style, const IdentifierNamingCheck::HungarianNotationOption &HNOption, IdentifierNamingCheck::CaseType Case) const
std::optional< RenamerClangTidyCheck::FailureInfo > getFailureInfo(StringRef Type, StringRef Name, const NamedDecl *ND, SourceLocation Location, ArrayRef< std::optional< IdentifierNamingCheck::NamingStyle > > NamingStyles, const IdentifierNamingCheck::HungarianNotationOption &HNOption, StyleKind SK, const SourceManager &SM, bool IgnoreFailedSplit) const
~IdentifierNamingCheck() override
std::string fixupWithStyle(StringRef Type, StringRef Name, const IdentifierNamingCheck::NamingStyle &Style, const IdentifierNamingCheck::HungarianNotationOption &HNOption, const Decl *D) const
IdentifierNamingCheck::FileStyle getFileStyleFromOptions(const ClangTidyCheck::OptionsView &Options) const
bool isParamInMainLikeFunction(const ParmVarDecl &ParmDecl, bool IncludeMainLike) const
bool matchesStyle(StringRef Type, StringRef Name, const IdentifierNamingCheck::NamingStyle &Style, const IdentifierNamingCheck::HungarianNotationOption &HNOption, const NamedDecl *Decl) const
StyleKind findStyleKind(const NamedDecl *D, ArrayRef< std::optional< IdentifierNamingCheck::NamingStyle > > NamingStyles, bool IgnoreMainLikeFunctions, bool CheckAnonFieldInParentScope) const
@ CT_LeadingUpperSnakeCase
void storeOptions(ClangTidyOptions::OptionMap &Opts) override
@ Type
An inlay hint that for a type annotation.
static StringRef const HungarianNotationPrimitiveTypes[]
static StringRef const HungarianNotationUserDefinedTypes[]
static StringRef const StyleNames[]
const IndirectFieldDecl * findOutermostIndirectFieldDeclForField(const FieldDecl *FD)
OptionMap CheckOptions
Key-value mapping used to store check-specific options.
std::optional< std::string > Checks
Checks filter.
llvm::StringMap< ClangTidyValue > OptionMap
static llvm::ArrayRef< std::pair< readability::IdentifierNamingCheck::CaseType, StringRef > > getEnumMapping()
static llvm::ArrayRef< std::pair< HungarianPrefixType, StringRef > > getEnumMapping()
readability::IdentifierNamingCheck::HungarianPrefixType HungarianPrefixType
This class should be specialized by any enum type that needs to be converted to and from an llvm::Str...
Information describing a failed check.
llvm::StringMap< std::string > UserDefinedType
llvm::StringMap< std::string > DerivedType
llvm::StringMap< std::string > CString
llvm::StringMap< std::string > General
llvm::StringMap< std::string > PrimitiveType
std::string getDeclTypeName(const NamedDecl *ND) const
bool isOptionEnabled(StringRef OptionKey, const llvm::StringMap< std::string > &StrMap) const
StringRef getClassPrefix(const CXXRecordDecl *CRD, const IdentifierNamingCheck::HungarianNotationOption &HNOption) const
bool removeDuplicatedPrefix(SmallVector< StringRef, 8 > &Words, const IdentifierNamingCheck::HungarianNotationOption &HNOption) const
void loadFileConfig(const ClangTidyCheck::OptionsView &Options, IdentifierNamingCheck::HungarianNotationOption &HNOption) const
void loadDefaultConfig(IdentifierNamingCheck::HungarianNotationOption &HNOption) const
std::string getEnumPrefix(const EnumConstantDecl *ECD) const
bool checkOptionValid(int StyleKindIndex) const
std::string getPrefix(const Decl *D, const IdentifierNamingCheck::HungarianNotationOption &HNOption) const
size_t getAsteriskCount(const std::string &TypeName) const
std::string getDataTypePrefix(StringRef TypeName, const NamedDecl *ND, const IdentifierNamingCheck::HungarianNotationOption &HNOption) const