//===--- UsingDeclarationsSorter.cpp ----------------------------*- C++ -*-===// // // The LLVM Compiler Infrastructure // // This file is distributed under the University of Illinois Open Source // License. See LICENSE.TXT for details. // //===----------------------------------------------------------------------===// /// /// \file /// \brief This file implements UsingDeclarationsSorter, a TokenAnalyzer that /// sorts consecutive using declarations. /// //===----------------------------------------------------------------------===// #include "UsingDeclarationsSorter.h" #include "llvm/Support/Debug.h" #include "llvm/Support/Regex.h" #include #define DEBUG_TYPE "using-declarations-sorter" namespace clang { namespace format { namespace { struct UsingDeclaration { const AnnotatedLine *Line; std::string Label; UsingDeclaration(const AnnotatedLine *Line, const std::string &Label) : Line(Line), Label(Label) {} // Compares lexicographically with the exception that '_' is just before 'A'. bool operator<(const UsingDeclaration &Other) const { size_t Size = Label.size(); size_t OtherSize = Other.Label.size(); for (size_t I = 0, E = std::min(Size, OtherSize); I < E; ++I) { char Rank = rank(Label[I]); char OtherRank = rank(Other.Label[I]); if (Rank != OtherRank) return Rank < OtherRank; } return Size < OtherSize; } // Returns the position of c in a lexicographic ordering with the exception // that '_' is just before 'A'. static char rank(char c) { if (c == '_') return 'A'; if ('A' <= c && c < '_') return c + 1; return c; } }; /// Computes the label of a using declaration starting at tthe using token /// \p UsingTok. /// If \p UsingTok doesn't begin a using declaration, returns the empty string. /// Note that this detects specifically using declarations, as in: /// using A::B::C; /// and not type aliases, as in: /// using A = B::C; /// Type aliases are in general not safe to permute. std::string computeUsingDeclarationLabel(const FormatToken *UsingTok) { assert(UsingTok && UsingTok->is(tok::kw_using) && "Expecting a using token"); std::string Label; const FormatToken *Tok = UsingTok->Next; if (Tok && Tok->is(tok::kw_typename)) { Label.append("typename "); Tok = Tok->Next; } if (Tok && Tok->is(tok::coloncolon)) { Label.append("::"); Tok = Tok->Next; } bool HasIdentifier = false; while (Tok && Tok->is(tok::identifier)) { HasIdentifier = true; Label.append(Tok->TokenText.str()); Tok = Tok->Next; if (!Tok || Tok->isNot(tok::coloncolon)) break; Label.append("::"); Tok = Tok->Next; } if (HasIdentifier && Tok && Tok->isOneOf(tok::semi, tok::comma)) return Label; return ""; } void endUsingDeclarationBlock( SmallVectorImpl *UsingDeclarations, const SourceManager &SourceMgr, tooling::Replacements *Fixes) { bool BlockAffected = false; for (const UsingDeclaration &Declaration : *UsingDeclarations) { if (Declaration.Line->Affected) { BlockAffected = true; break; } } if (!BlockAffected) { UsingDeclarations->clear(); return; } SmallVector SortedUsingDeclarations( UsingDeclarations->begin(), UsingDeclarations->end()); std::stable_sort(SortedUsingDeclarations.begin(), SortedUsingDeclarations.end()); for (size_t I = 0, E = UsingDeclarations->size(); I < E; ++I) { if ((*UsingDeclarations)[I].Line == SortedUsingDeclarations[I].Line) continue; auto Begin = (*UsingDeclarations)[I].Line->First->Tok.getLocation(); auto End = (*UsingDeclarations)[I].Line->Last->Tok.getEndLoc(); auto SortedBegin = SortedUsingDeclarations[I].Line->First->Tok.getLocation(); auto SortedEnd = SortedUsingDeclarations[I].Line->Last->Tok.getEndLoc(); StringRef Text(SourceMgr.getCharacterData(SortedBegin), SourceMgr.getCharacterData(SortedEnd) - SourceMgr.getCharacterData(SortedBegin)); DEBUG({ StringRef OldText(SourceMgr.getCharacterData(Begin), SourceMgr.getCharacterData(End) - SourceMgr.getCharacterData(Begin)); llvm::dbgs() << "Replacing '" << OldText << "' with '" << Text << "'\n"; }); auto Range = CharSourceRange::getCharRange(Begin, End); auto Err = Fixes->add(tooling::Replacement(SourceMgr, Range, Text)); if (Err) { llvm::errs() << "Error while sorting using declarations: " << llvm::toString(std::move(Err)) << "\n"; } } UsingDeclarations->clear(); } } // namespace UsingDeclarationsSorter::UsingDeclarationsSorter(const Environment &Env, const FormatStyle &Style) : TokenAnalyzer(Env, Style) {} std::pair UsingDeclarationsSorter::analyze( TokenAnnotator &Annotator, SmallVectorImpl &AnnotatedLines, FormatTokenLexer &Tokens) { const SourceManager &SourceMgr = Env.getSourceManager(); AffectedRangeMgr.computeAffectedLines(AnnotatedLines.begin(), AnnotatedLines.end()); tooling::Replacements Fixes; SmallVector UsingDeclarations; for (size_t I = 0, E = AnnotatedLines.size(); I != E; ++I) { if (AnnotatedLines[I]->InPPDirective || !AnnotatedLines[I]->startsWith(tok::kw_using) || AnnotatedLines[I]->First->Finalized) { endUsingDeclarationBlock(&UsingDeclarations, SourceMgr, &Fixes); continue; } if (AnnotatedLines[I]->First->NewlinesBefore > 1) endUsingDeclarationBlock(&UsingDeclarations, SourceMgr, &Fixes); std::string Label = computeUsingDeclarationLabel(AnnotatedLines[I]->First); if (Label.empty()) { endUsingDeclarationBlock(&UsingDeclarations, SourceMgr, &Fixes); continue; } UsingDeclarations.push_back(UsingDeclaration(AnnotatedLines[I], Label)); } endUsingDeclarationBlock(&UsingDeclarations, SourceMgr, &Fixes); return {Fixes, 0}; } } // namespace format } // namespace clang