//===--- WhitespaceManager.cpp - Format C++ code --------------------------===// // // 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 // //===----------------------------------------------------------------------===// /// /// \file /// This file implements WhitespaceManager class. /// //===----------------------------------------------------------------------===// #include "WhitespaceManager.h" #include "llvm/ADT/STLExtras.h" #include "llvm/ADT/SmallVector.h" #include namespace clang { namespace format { bool WhitespaceManager::Change::IsBeforeInFile::operator()( const Change &C1, const Change &C2) const { return SourceMgr.isBeforeInTranslationUnit( C1.OriginalWhitespaceRange.getBegin(), C2.OriginalWhitespaceRange.getBegin()); } WhitespaceManager::Change::Change(const FormatToken &Tok, bool CreateReplacement, SourceRange OriginalWhitespaceRange, int Spaces, unsigned StartOfTokenColumn, unsigned NewlinesBefore, StringRef PreviousLinePostfix, StringRef CurrentLinePrefix, bool IsAligned, bool ContinuesPPDirective, bool IsInsideToken) : Tok(&Tok), CreateReplacement(CreateReplacement), OriginalWhitespaceRange(OriginalWhitespaceRange), StartOfTokenColumn(StartOfTokenColumn), NewlinesBefore(NewlinesBefore), PreviousLinePostfix(PreviousLinePostfix), CurrentLinePrefix(CurrentLinePrefix), IsAligned(IsAligned), ContinuesPPDirective(ContinuesPPDirective), Spaces(Spaces), IsInsideToken(IsInsideToken), IsTrailingComment(false), TokenLength(0), PreviousEndOfTokenColumn(0), EscapedNewlineColumn(0), StartOfBlockComment(nullptr), IndentationOffset(0), ConditionalsLevel(0) { } void WhitespaceManager::replaceWhitespace(FormatToken &Tok, unsigned Newlines, unsigned Spaces, unsigned StartOfTokenColumn, bool IsAligned, bool InPPDirective) { if (Tok.Finalized) return; Tok.setDecision((Newlines > 0) ? FD_Break : FD_Continue); Changes.push_back(Change(Tok, /*CreateReplacement=*/true, Tok.WhitespaceRange, Spaces, StartOfTokenColumn, Newlines, "", "", IsAligned, InPPDirective && !Tok.IsFirst, /*IsInsideToken=*/false)); } void WhitespaceManager::addUntouchableToken(const FormatToken &Tok, bool InPPDirective) { if (Tok.Finalized) return; Changes.push_back(Change(Tok, /*CreateReplacement=*/false, Tok.WhitespaceRange, /*Spaces=*/0, Tok.OriginalColumn, Tok.NewlinesBefore, "", "", /*IsAligned=*/false, InPPDirective && !Tok.IsFirst, /*IsInsideToken=*/false)); } llvm::Error WhitespaceManager::addReplacement(const tooling::Replacement &Replacement) { return Replaces.add(Replacement); } bool WhitespaceManager::inputUsesCRLF(StringRef Text, bool DefaultToCRLF) { size_t LF = Text.count('\n'); size_t CR = Text.count('\r') * 2; return LF == CR ? DefaultToCRLF : CR > LF; } void WhitespaceManager::replaceWhitespaceInToken( const FormatToken &Tok, unsigned Offset, unsigned ReplaceChars, StringRef PreviousPostfix, StringRef CurrentPrefix, bool InPPDirective, unsigned Newlines, int Spaces) { if (Tok.Finalized) return; SourceLocation Start = Tok.getStartOfNonWhitespace().getLocWithOffset(Offset); Changes.push_back( Change(Tok, /*CreateReplacement=*/true, SourceRange(Start, Start.getLocWithOffset(ReplaceChars)), Spaces, std::max(0, Spaces), Newlines, PreviousPostfix, CurrentPrefix, /*IsAligned=*/true, InPPDirective && !Tok.IsFirst, /*IsInsideToken=*/true)); } const tooling::Replacements &WhitespaceManager::generateReplacements() { if (Changes.empty()) return Replaces; llvm::sort(Changes, Change::IsBeforeInFile(SourceMgr)); calculateLineBreakInformation(); alignConsecutiveMacros(); alignConsecutiveDeclarations(); alignConsecutiveBitFields(); alignConsecutiveAssignments(); alignChainedConditionals(); alignTrailingComments(); alignEscapedNewlines(); alignArrayInitializers(); generateChanges(); return Replaces; } void WhitespaceManager::calculateLineBreakInformation() { Changes[0].PreviousEndOfTokenColumn = 0; Change *LastOutsideTokenChange = &Changes[0]; for (unsigned i = 1, e = Changes.size(); i != e; ++i) { SourceLocation OriginalWhitespaceStart = Changes[i].OriginalWhitespaceRange.getBegin(); SourceLocation PreviousOriginalWhitespaceEnd = Changes[i - 1].OriginalWhitespaceRange.getEnd(); unsigned OriginalWhitespaceStartOffset = SourceMgr.getFileOffset(OriginalWhitespaceStart); unsigned PreviousOriginalWhitespaceEndOffset = SourceMgr.getFileOffset(PreviousOriginalWhitespaceEnd); assert(PreviousOriginalWhitespaceEndOffset <= OriginalWhitespaceStartOffset); const char *const PreviousOriginalWhitespaceEndData = SourceMgr.getCharacterData(PreviousOriginalWhitespaceEnd); StringRef Text(PreviousOriginalWhitespaceEndData, SourceMgr.getCharacterData(OriginalWhitespaceStart) - PreviousOriginalWhitespaceEndData); // Usually consecutive changes would occur in consecutive tokens. This is // not the case however when analyzing some preprocessor runs of the // annotated lines. For example, in this code: // // #if A // line 1 // int i = 1; // #else B // line 2 // int i = 2; // #endif // line 3 // // one of the runs will produce the sequence of lines marked with line 1, 2 // and 3. So the two consecutive whitespace changes just before '// line 2' // and before '#endif // line 3' span multiple lines and tokens: // // #else B{change X}[// line 2 // int i = 2; // ]{change Y}#endif // line 3 // // For this reason, if the text between consecutive changes spans multiple // newlines, the token length must be adjusted to the end of the original // line of the token. auto NewlinePos = Text.find_first_of('\n'); if (NewlinePos == StringRef::npos) { Changes[i - 1].TokenLength = OriginalWhitespaceStartOffset - PreviousOriginalWhitespaceEndOffset + Changes[i].PreviousLinePostfix.size() + Changes[i - 1].CurrentLinePrefix.size(); } else { Changes[i - 1].TokenLength = NewlinePos + Changes[i - 1].CurrentLinePrefix.size(); } // If there are multiple changes in this token, sum up all the changes until // the end of the line. if (Changes[i - 1].IsInsideToken && Changes[i - 1].NewlinesBefore == 0) { LastOutsideTokenChange->TokenLength += Changes[i - 1].TokenLength + Changes[i - 1].Spaces; } else { LastOutsideTokenChange = &Changes[i - 1]; } Changes[i].PreviousEndOfTokenColumn = Changes[i - 1].StartOfTokenColumn + Changes[i - 1].TokenLength; Changes[i - 1].IsTrailingComment = (Changes[i].NewlinesBefore > 0 || Changes[i].Tok->is(tok::eof) || (Changes[i].IsInsideToken && Changes[i].Tok->is(tok::comment))) && Changes[i - 1].Tok->is(tok::comment) && // FIXME: This is a dirty hack. The problem is that // BreakableLineCommentSection does comment reflow changes and here is // the aligning of trailing comments. Consider the case where we reflow // the second line up in this example: // // // line 1 // // line 2 // // That amounts to 2 changes by BreakableLineCommentSection: // - the first, delimited by (), for the whitespace between the tokens, // - and second, delimited by [], for the whitespace at the beginning // of the second token: // // // line 1( // )[// ]line 2 // // So in the end we have two changes like this: // // // line1()[ ]line 2 // // Note that the OriginalWhitespaceStart of the second change is the // same as the PreviousOriginalWhitespaceEnd of the first change. // In this case, the below check ensures that the second change doesn't // get treated as a trailing comment change here, since this might // trigger additional whitespace to be wrongly inserted before "line 2" // by the comment aligner here. // // For a proper solution we need a mechanism to say to WhitespaceManager // that a particular change breaks the current sequence of trailing // comments. OriginalWhitespaceStart != PreviousOriginalWhitespaceEnd; } // FIXME: The last token is currently not always an eof token; in those // cases, setting TokenLength of the last token to 0 is wrong. Changes.back().TokenLength = 0; Changes.back().IsTrailingComment = Changes.back().Tok->is(tok::comment); const WhitespaceManager::Change *LastBlockComment = nullptr; for (auto &Change : Changes) { // Reset the IsTrailingComment flag for changes inside of trailing comments // so they don't get realigned later. Comment line breaks however still need // to be aligned. if (Change.IsInsideToken && Change.NewlinesBefore == 0) Change.IsTrailingComment = false; Change.StartOfBlockComment = nullptr; Change.IndentationOffset = 0; if (Change.Tok->is(tok::comment)) { if (Change.Tok->is(TT_LineComment) || !Change.IsInsideToken) { LastBlockComment = &Change; } else if ((Change.StartOfBlockComment = LastBlockComment)) { Change.IndentationOffset = Change.StartOfTokenColumn - Change.StartOfBlockComment->StartOfTokenColumn; } } else { LastBlockComment = nullptr; } } // Compute conditional nesting level // Level is increased for each conditional, unless this conditional continues // a chain of conditional, i.e. starts immediately after the colon of another // conditional. SmallVector ScopeStack; int ConditionalsLevel = 0; for (auto &Change : Changes) { for (unsigned i = 0, e = Change.Tok->FakeLParens.size(); i != e; ++i) { bool isNestedConditional = Change.Tok->FakeLParens[e - 1 - i] == prec::Conditional && !(i == 0 && Change.Tok->Previous && Change.Tok->Previous->is(TT_ConditionalExpr) && Change.Tok->Previous->is(tok::colon)); if (isNestedConditional) ++ConditionalsLevel; ScopeStack.push_back(isNestedConditional); } Change.ConditionalsLevel = ConditionalsLevel; for (unsigned i = Change.Tok->FakeRParens; i > 0 && ScopeStack.size(); --i) if (ScopeStack.pop_back_val()) --ConditionalsLevel; } } // Align a single sequence of tokens, see AlignTokens below. // Column - The token for which Matches returns true is moved to this column. // RightJustify - Whether it is the token's right end or left end that gets // moved to that column. template static void AlignTokenSequence(const FormatStyle &Style, unsigned Start, unsigned End, unsigned Column, bool RightJustify, F &&Matches, SmallVector &Changes) { bool FoundMatchOnLine = false; int Shift = 0; // ScopeStack keeps track of the current scope depth. It contains indices of // the first token on each scope. // We only run the "Matches" function on tokens from the outer-most scope. // However, we do need to pay special attention to one class of tokens // that are not in the outer-most scope, and that is function parameters // which are split across multiple lines, as illustrated by this example: // double a(int x); // int b(int y, // double z); // In the above example, we need to take special care to ensure that // 'double z' is indented along with it's owning function 'b'. // The same holds for calling a function: // double a = foo(x); // int b = bar(foo(y), // foor(z)); // Similar for broken string literals: // double x = 3.14; // auto s = "Hello" // "World"; // Special handling is required for 'nested' ternary operators. SmallVector ScopeStack; for (unsigned i = Start; i != End; ++i) { if (ScopeStack.size() != 0 && Changes[i].indentAndNestingLevel() < Changes[ScopeStack.back()].indentAndNestingLevel()) { ScopeStack.pop_back(); } // Compare current token to previous non-comment token to ensure whether // it is in a deeper scope or not. unsigned PreviousNonComment = i - 1; while (PreviousNonComment > Start && Changes[PreviousNonComment].Tok->is(tok::comment)) { --PreviousNonComment; } if (i != Start && Changes[i].indentAndNestingLevel() > Changes[PreviousNonComment].indentAndNestingLevel()) { ScopeStack.push_back(i); } bool InsideNestedScope = ScopeStack.size() != 0; bool ContinuedStringLiteral = i > Start && Changes[i].Tok->is(tok::string_literal) && Changes[i - 1].Tok->is(tok::string_literal); bool SkipMatchCheck = InsideNestedScope || ContinuedStringLiteral; if (Changes[i].NewlinesBefore > 0 && !SkipMatchCheck) { Shift = 0; FoundMatchOnLine = false; } // If this is the first matching token to be aligned, remember by how many // spaces it has to be shifted, so the rest of the changes on the line are // shifted by the same amount if (!FoundMatchOnLine && !SkipMatchCheck && Matches(Changes[i])) { FoundMatchOnLine = true; Shift = Column - (RightJustify ? Changes[i].TokenLength : 0) - Changes[i].StartOfTokenColumn; Changes[i].Spaces += Shift; // FIXME: This is a workaround that should be removed when we fix // http://llvm.org/PR53699. An assertion later below verifies this. if (Changes[i].NewlinesBefore == 0) { Changes[i].Spaces = std::max(Changes[i].Spaces, static_cast(Changes[i].Tok->SpacesRequiredBefore)); } } // This is for function parameters that are split across multiple lines, // as mentioned in the ScopeStack comment. if (InsideNestedScope && Changes[i].NewlinesBefore > 0) { unsigned ScopeStart = ScopeStack.back(); auto ShouldShiftBeAdded = [&] { // Function declaration if (Changes[ScopeStart - 1].Tok->is(TT_FunctionDeclarationName)) return true; // Lambda. if (Changes[ScopeStart - 1].Tok->is(TT_LambdaLBrace)) return false; // Continued function declaration if (ScopeStart > Start + 1 && Changes[ScopeStart - 2].Tok->is(TT_FunctionDeclarationName)) { return true; } // Continued function call if (ScopeStart > Start + 1 && Changes[ScopeStart - 2].Tok->is(tok::identifier) && Changes[ScopeStart - 1].Tok->is(tok::l_paren) && Changes[ScopeStart].Tok->isNot(TT_LambdaLSquare)) { if (Changes[i].Tok->MatchingParen && Changes[i].Tok->MatchingParen->is(TT_LambdaLBrace)) { return false; } if (Changes[ScopeStart].NewlinesBefore > 0) return false; if (Changes[i].Tok->is(tok::l_brace) && Changes[i].Tok->is(BK_BracedInit)) { return true; } return Style.BinPackArguments; } // Ternary operator if (Changes[i].Tok->is(TT_ConditionalExpr)) return true; // Period Initializer .XXX = 1. if (Changes[i].Tok->is(TT_DesignatedInitializerPeriod)) return true; // Continued ternary operator if (Changes[i].Tok->Previous && Changes[i].Tok->Previous->is(TT_ConditionalExpr)) { return true; } // Continued direct-list-initialization using braced list. if (ScopeStart > Start + 1 && Changes[ScopeStart - 2].Tok->is(tok::identifier) && Changes[ScopeStart - 1].Tok->is(tok::l_brace) && Changes[i].Tok->is(tok::l_brace) && Changes[i].Tok->is(BK_BracedInit)) { return true; } // Continued braced list. if (ScopeStart > Start + 1 && Changes[ScopeStart - 2].Tok->isNot(tok::identifier) && Changes[ScopeStart - 1].Tok->is(tok::l_brace) && Changes[i].Tok->isNot(tok::r_brace)) { for (unsigned OuterScopeStart : llvm::reverse(ScopeStack)) { // Lambda. if (OuterScopeStart > Start && Changes[OuterScopeStart - 1].Tok->is(TT_LambdaLBrace)) { return false; } } if (Changes[ScopeStart].NewlinesBefore > 0) return false; return true; } return false; }; if (ShouldShiftBeAdded()) Changes[i].Spaces += Shift; } if (ContinuedStringLiteral) Changes[i].Spaces += Shift; // We should not remove required spaces unless we break the line before. assert(Shift >= 0 || Changes[i].NewlinesBefore > 0 || Changes[i].Spaces >= static_cast(Changes[i].Tok->SpacesRequiredBefore) || Changes[i].Tok->is(tok::eof)); Changes[i].StartOfTokenColumn += Shift; if (i + 1 != Changes.size()) Changes[i + 1].PreviousEndOfTokenColumn += Shift; // If PointerAlignment is PAS_Right, keep *s or &s next to the token if (Style.PointerAlignment == FormatStyle::PAS_Right && Changes[i].Spaces != 0) { for (int Previous = i - 1; Previous >= 0 && Changes[Previous].Tok->getType() == TT_PointerOrReference; --Previous) { Changes[Previous + 1].Spaces -= Shift; Changes[Previous].Spaces += Shift; Changes[Previous].StartOfTokenColumn += Shift; } } } } // Walk through a subset of the changes, starting at StartAt, and find // sequences of matching tokens to align. To do so, keep track of the lines and // whether or not a matching token was found on a line. If a matching token is // found, extend the current sequence. If the current line cannot be part of a // sequence, e.g. because there is an empty line before it or it contains only // non-matching tokens, finalize the previous sequence. // The value returned is the token on which we stopped, either because we // exhausted all items inside Changes, or because we hit a scope level higher // than our initial scope. // This function is recursive. Each invocation processes only the scope level // equal to the initial level, which is the level of Changes[StartAt]. // If we encounter a scope level greater than the initial level, then we call // ourselves recursively, thereby avoiding the pollution of the current state // with the alignment requirements of the nested sub-level. This recursive // behavior is necessary for aligning function prototypes that have one or more // arguments. // If this function encounters a scope level less than the initial level, // it returns the current position. // There is a non-obvious subtlety in the recursive behavior: Even though we // defer processing of nested levels to recursive invocations of this // function, when it comes time to align a sequence of tokens, we run the // alignment on the entire sequence, including the nested levels. // When doing so, most of the nested tokens are skipped, because their // alignment was already handled by the recursive invocations of this function. // However, the special exception is that we do NOT skip function parameters // that are split across multiple lines. See the test case in FormatTest.cpp // that mentions "split function parameter alignment" for an example of this. // When the parameter RightJustify is true, the operator will be // right-justified. It is used to align compound assignments like `+=` and `=`. // When RightJustify and ACS.PadOperators are true, operators in each block to // be aligned will be padded on the left to the same length before aligning. template static unsigned AlignTokens(const FormatStyle &Style, F &&Matches, SmallVector &Changes, unsigned StartAt, const FormatStyle::AlignConsecutiveStyle &ACS = {}, bool RightJustify = false) { // We arrange each line in 3 parts. The operator to be aligned (the anchor), // and text to its left and right. In the aligned text the width of each part // will be the maximum of that over the block that has been aligned. Maximum // widths of each part so far. When RightJustify is true and ACS.PadOperators // is false, the part from start of line to the right end of the anchor. // Otherwise, only the part to the left of the anchor. Including the space // that exists on its left from the start. Not including the padding added on // the left to right-justify the anchor. unsigned WidthLeft = 0; // The operator to be aligned when RightJustify is true and ACS.PadOperators // is false. 0 otherwise. unsigned WidthAnchor = 0; // Width to the right of the anchor. Plus width of the anchor when // RightJustify is false. unsigned WidthRight = 0; // Line number of the start and the end of the current token sequence. unsigned StartOfSequence = 0; unsigned EndOfSequence = 0; // Measure the scope level (i.e. depth of (), [], {}) of the first token, and // abort when we hit any token in a higher scope than the starting one. auto IndentAndNestingLevel = StartAt < Changes.size() ? Changes[StartAt].indentAndNestingLevel() : std::tuple(); // Keep track if the first token has a non-zero indent and nesting level. // This can happen when aligning the contents of "#else" preprocessor blocks, // which is done separately. bool HasInitialIndentAndNesting = StartAt == 0 && IndentAndNestingLevel > std::tuple(); // Keep track of the number of commas before the matching tokens, we will only // align a sequence of matching tokens if they are preceded by the same number // of commas. unsigned CommasBeforeLastMatch = 0; unsigned CommasBeforeMatch = 0; // Whether a matching token has been found on the current line. bool FoundMatchOnLine = false; // Whether the current line consists purely of comments. bool LineIsComment = true; // Aligns a sequence of matching tokens, on the MinColumn column. // // Sequences start from the first matching token to align, and end at the // first token of the first line that doesn't need to be aligned. // // We need to adjust the StartOfTokenColumn of each Change that is on a line // containing any matching token to be aligned and located after such token. auto AlignCurrentSequence = [&] { if (StartOfSequence > 0 && StartOfSequence < EndOfSequence) { AlignTokenSequence(Style, StartOfSequence, EndOfSequence, WidthLeft + WidthAnchor, RightJustify, Matches, Changes); } WidthLeft = 0; WidthAnchor = 0; WidthRight = 0; StartOfSequence = 0; EndOfSequence = 0; }; unsigned i = StartAt; for (unsigned e = Changes.size(); i != e; ++i) { if (Changes[i].indentAndNestingLevel() < IndentAndNestingLevel) { if (!HasInitialIndentAndNesting) break; // The contents of preprocessor blocks are aligned separately. // If the initial preprocessor block is indented or nested (e.g. it's in // a function), do not align and exit after finishing this scope block. // Instead, align, and then lower the baseline indent and nesting level // in order to continue aligning subsequent blocks. EndOfSequence = i; AlignCurrentSequence(); IndentAndNestingLevel = Changes[i].indentAndNestingLevel(); // new baseline } if (Changes[i].NewlinesBefore != 0) { CommasBeforeMatch = 0; EndOfSequence = i; // Whether to break the alignment sequence because of an empty line. bool EmptyLineBreak = (Changes[i].NewlinesBefore > 1) && !ACS.AcrossEmptyLines; // Whether to break the alignment sequence because of a line without a // match. bool NoMatchBreak = !FoundMatchOnLine && !(LineIsComment && ACS.AcrossComments); if (EmptyLineBreak || NoMatchBreak) AlignCurrentSequence(); // A new line starts, re-initialize line status tracking bools. // Keep the match state if a string literal is continued on this line. if (i == 0 || !Changes[i].Tok->is(tok::string_literal) || !Changes[i - 1].Tok->is(tok::string_literal)) { FoundMatchOnLine = false; } LineIsComment = true; } if (!Changes[i].Tok->is(tok::comment)) LineIsComment = false; if (Changes[i].Tok->is(tok::comma)) { ++CommasBeforeMatch; } else if (Changes[i].indentAndNestingLevel() > IndentAndNestingLevel) { // Call AlignTokens recursively, skipping over this scope block. unsigned StoppedAt = AlignTokens(Style, Matches, Changes, i, ACS, RightJustify); i = StoppedAt - 1; continue; } if (!Matches(Changes[i])) continue; // If there is more than one matching token per line, or if the number of // preceding commas, do not match anymore, end the sequence. if (FoundMatchOnLine || CommasBeforeMatch != CommasBeforeLastMatch) AlignCurrentSequence(); CommasBeforeLastMatch = CommasBeforeMatch; FoundMatchOnLine = true; if (StartOfSequence == 0) StartOfSequence = i; unsigned ChangeWidthLeft = Changes[i].StartOfTokenColumn; unsigned ChangeWidthAnchor = 0; unsigned ChangeWidthRight = 0; if (RightJustify) if (ACS.PadOperators) ChangeWidthAnchor = Changes[i].TokenLength; else ChangeWidthLeft += Changes[i].TokenLength; else ChangeWidthRight = Changes[i].TokenLength; for (unsigned j = i + 1; j != e && Changes[j].NewlinesBefore == 0; ++j) { ChangeWidthRight += Changes[j].Spaces; // Changes are generally 1:1 with the tokens, but a change could also be // inside of a token, in which case it's counted more than once: once for // the whitespace surrounding the token (!IsInsideToken) and once for // each whitespace change within it (IsInsideToken). // Therefore, changes inside of a token should only count the space. if (!Changes[j].IsInsideToken) ChangeWidthRight += Changes[j].TokenLength; } // If we are restricted by the maximum column width, end the sequence. unsigned NewLeft = std::max(ChangeWidthLeft, WidthLeft); unsigned NewAnchor = std::max(ChangeWidthAnchor, WidthAnchor); unsigned NewRight = std::max(ChangeWidthRight, WidthRight); // `ColumnLimit == 0` means there is no column limit. if (Style.ColumnLimit != 0 && Style.ColumnLimit < NewLeft + NewAnchor + NewRight) { AlignCurrentSequence(); StartOfSequence = i; WidthLeft = ChangeWidthLeft; WidthAnchor = ChangeWidthAnchor; WidthRight = ChangeWidthRight; } else { WidthLeft = NewLeft; WidthAnchor = NewAnchor; WidthRight = NewRight; } } EndOfSequence = i; AlignCurrentSequence(); return i; } // Aligns a sequence of matching tokens, on the MinColumn column. // // Sequences start from the first matching token to align, and end at the // first token of the first line that doesn't need to be aligned. // // We need to adjust the StartOfTokenColumn of each Change that is on a line // containing any matching token to be aligned and located after such token. static void AlignMacroSequence( unsigned &StartOfSequence, unsigned &EndOfSequence, unsigned &MinColumn, unsigned &MaxColumn, bool &FoundMatchOnLine, std::function AlignMacrosMatches, SmallVector &Changes) { if (StartOfSequence > 0 && StartOfSequence < EndOfSequence) { FoundMatchOnLine = false; int Shift = 0; for (unsigned I = StartOfSequence; I != EndOfSequence; ++I) { if (Changes[I].NewlinesBefore > 0) { Shift = 0; FoundMatchOnLine = false; } // If this is the first matching token to be aligned, remember by how many // spaces it has to be shifted, so the rest of the changes on the line are // shifted by the same amount if (!FoundMatchOnLine && AlignMacrosMatches(Changes[I])) { FoundMatchOnLine = true; Shift = MinColumn - Changes[I].StartOfTokenColumn; Changes[I].Spaces += Shift; } assert(Shift >= 0); Changes[I].StartOfTokenColumn += Shift; if (I + 1 != Changes.size()) Changes[I + 1].PreviousEndOfTokenColumn += Shift; } } MinColumn = 0; MaxColumn = UINT_MAX; StartOfSequence = 0; EndOfSequence = 0; } void WhitespaceManager::alignConsecutiveMacros() { if (!Style.AlignConsecutiveMacros.Enabled) return; auto AlignMacrosMatches = [](const Change &C) { const FormatToken *Current = C.Tok; unsigned SpacesRequiredBefore = 1; if (Current->SpacesRequiredBefore == 0 || !Current->Previous) return false; Current = Current->Previous; // If token is a ")", skip over the parameter list, to the // token that precedes the "(" if (Current->is(tok::r_paren) && Current->MatchingParen) { Current = Current->MatchingParen->Previous; SpacesRequiredBefore = 0; } if (!Current || !Current->is(tok::identifier)) return false; if (!Current->Previous || !Current->Previous->is(tok::pp_define)) return false; // For a macro function, 0 spaces are required between the // identifier and the lparen that opens the parameter list. // For a simple macro, 1 space is required between the // identifier and the first token of the defined value. return Current->Next->SpacesRequiredBefore == SpacesRequiredBefore; }; unsigned MinColumn = 0; unsigned MaxColumn = UINT_MAX; // Start and end of the token sequence we're processing. unsigned StartOfSequence = 0; unsigned EndOfSequence = 0; // Whether a matching token has been found on the current line. bool FoundMatchOnLine = false; // Whether the current line consists only of comments bool LineIsComment = true; unsigned I = 0; for (unsigned E = Changes.size(); I != E; ++I) { if (Changes[I].NewlinesBefore != 0) { EndOfSequence = I; // Whether to break the alignment sequence because of an empty line. bool EmptyLineBreak = (Changes[I].NewlinesBefore > 1) && !Style.AlignConsecutiveMacros.AcrossEmptyLines; // Whether to break the alignment sequence because of a line without a // match. bool NoMatchBreak = !FoundMatchOnLine && !(LineIsComment && Style.AlignConsecutiveMacros.AcrossComments); if (EmptyLineBreak || NoMatchBreak) { AlignMacroSequence(StartOfSequence, EndOfSequence, MinColumn, MaxColumn, FoundMatchOnLine, AlignMacrosMatches, Changes); } // A new line starts, re-initialize line status tracking bools. FoundMatchOnLine = false; LineIsComment = true; } if (!Changes[I].Tok->is(tok::comment)) LineIsComment = false; if (!AlignMacrosMatches(Changes[I])) continue; FoundMatchOnLine = true; if (StartOfSequence == 0) StartOfSequence = I; unsigned ChangeMinColumn = Changes[I].StartOfTokenColumn; int LineLengthAfter = -Changes[I].Spaces; for (unsigned j = I; j != E && Changes[j].NewlinesBefore == 0; ++j) LineLengthAfter += Changes[j].Spaces + Changes[j].TokenLength; unsigned ChangeMaxColumn = Style.ColumnLimit - LineLengthAfter; MinColumn = std::max(MinColumn, ChangeMinColumn); MaxColumn = std::min(MaxColumn, ChangeMaxColumn); } EndOfSequence = I; AlignMacroSequence(StartOfSequence, EndOfSequence, MinColumn, MaxColumn, FoundMatchOnLine, AlignMacrosMatches, Changes); } void WhitespaceManager::alignConsecutiveAssignments() { if (!Style.AlignConsecutiveAssignments.Enabled) return; AlignTokens( Style, [&](const Change &C) { // Do not align on equal signs that are first on a line. if (C.NewlinesBefore > 0) return false; // Do not align on equal signs that are last on a line. if (&C != &Changes.back() && (&C + 1)->NewlinesBefore > 0) return false; // Do not align operator= overloads. FormatToken *Previous = C.Tok->getPreviousNonComment(); if (Previous && Previous->is(tok::kw_operator)) return false; return Style.AlignConsecutiveAssignments.AlignCompound ? C.Tok->getPrecedence() == prec::Assignment : C.Tok->is(tok::equal); }, Changes, /*StartAt=*/0, Style.AlignConsecutiveAssignments, /*RightJustify=*/true); } void WhitespaceManager::alignConsecutiveBitFields() { if (!Style.AlignConsecutiveBitFields.Enabled) return; AlignTokens( Style, [&](Change const &C) { // Do not align on ':' that is first on a line. if (C.NewlinesBefore > 0) return false; // Do not align on ':' that is last on a line. if (&C != &Changes.back() && (&C + 1)->NewlinesBefore > 0) return false; return C.Tok->is(TT_BitFieldColon); }, Changes, /*StartAt=*/0, Style.AlignConsecutiveBitFields); } void WhitespaceManager::alignConsecutiveDeclarations() { if (!Style.AlignConsecutiveDeclarations.Enabled) return; AlignTokens( Style, [](Change const &C) { if (C.Tok->is(TT_FunctionDeclarationName)) return true; if (C.Tok->isNot(TT_StartOfName)) return false; if (C.Tok->Previous && C.Tok->Previous->is(TT_StatementAttributeLikeMacro)) return false; // Check if there is a subsequent name that starts the same declaration. for (FormatToken *Next = C.Tok->Next; Next; Next = Next->Next) { if (Next->is(tok::comment)) continue; if (Next->is(TT_PointerOrReference)) return false; if (!Next->Tok.getIdentifierInfo()) break; if (Next->isOneOf(TT_StartOfName, TT_FunctionDeclarationName, tok::kw_operator)) { return false; } } return true; }, Changes, /*StartAt=*/0, Style.AlignConsecutiveDeclarations); } void WhitespaceManager::alignChainedConditionals() { if (Style.BreakBeforeTernaryOperators) { AlignTokens( Style, [](Change const &C) { // Align question operators and last colon return C.Tok->is(TT_ConditionalExpr) && ((C.Tok->is(tok::question) && !C.NewlinesBefore) || (C.Tok->is(tok::colon) && C.Tok->Next && (C.Tok->Next->FakeLParens.size() == 0 || C.Tok->Next->FakeLParens.back() != prec::Conditional))); }, Changes, /*StartAt=*/0); } else { static auto AlignWrappedOperand = [](Change const &C) { FormatToken *Previous = C.Tok->getPreviousNonComment(); return C.NewlinesBefore && Previous && Previous->is(TT_ConditionalExpr) && (Previous->is(tok::colon) && (C.Tok->FakeLParens.size() == 0 || C.Tok->FakeLParens.back() != prec::Conditional)); }; // Ensure we keep alignment of wrapped operands with non-wrapped operands // Since we actually align the operators, the wrapped operands need the // extra offset to be properly aligned. for (Change &C : Changes) if (AlignWrappedOperand(C)) C.StartOfTokenColumn -= 2; AlignTokens( Style, [this](Change const &C) { // Align question operators if next operand is not wrapped, as // well as wrapped operands after question operator or last // colon in conditional sequence return (C.Tok->is(TT_ConditionalExpr) && C.Tok->is(tok::question) && &C != &Changes.back() && (&C + 1)->NewlinesBefore == 0 && !(&C + 1)->IsTrailingComment) || AlignWrappedOperand(C); }, Changes, /*StartAt=*/0); } } void WhitespaceManager::alignTrailingComments() { unsigned MinColumn = 0; unsigned MaxColumn = UINT_MAX; unsigned StartOfSequence = 0; bool BreakBeforeNext = false; unsigned Newlines = 0; unsigned int NewLineThreshold = 1; if (Style.AlignTrailingComments.Kind == FormatStyle::TCAS_Always) NewLineThreshold = Style.AlignTrailingComments.OverEmptyLines + 1; for (unsigned i = 0, e = Changes.size(); i != e; ++i) { if (Changes[i].StartOfBlockComment) continue; Newlines += Changes[i].NewlinesBefore; if (!Changes[i].IsTrailingComment) continue; if (Style.AlignTrailingComments.Kind == FormatStyle::TCAS_Leave) { auto OriginalSpaces = Changes[i].OriginalWhitespaceRange.getEnd().getRawEncoding() - Changes[i].OriginalWhitespaceRange.getBegin().getRawEncoding() - Changes[i].Tok->NewlinesBefore; unsigned RestoredLineLength = Changes[i].StartOfTokenColumn + Changes[i].TokenLength + OriginalSpaces; // If leaving comments makes the line exceed the column limit, give up to // leave the comments. if (RestoredLineLength >= Style.ColumnLimit && Style.ColumnLimit != 0) break; Changes[i].Spaces = OriginalSpaces; continue; } unsigned ChangeMinColumn = Changes[i].StartOfTokenColumn; unsigned ChangeMaxColumn; if (Style.ColumnLimit == 0) ChangeMaxColumn = UINT_MAX; else if (Style.ColumnLimit >= Changes[i].TokenLength) ChangeMaxColumn = Style.ColumnLimit - Changes[i].TokenLength; else ChangeMaxColumn = ChangeMinColumn; // If we don't create a replacement for this change, we have to consider // it to be immovable. if (!Changes[i].CreateReplacement) ChangeMaxColumn = ChangeMinColumn; if (i + 1 != e && Changes[i + 1].ContinuesPPDirective) ChangeMaxColumn -= 2; // If this comment follows an } in column 0, it probably documents the // closing of a namespace and we don't want to align it. bool FollowsRBraceInColumn0 = i > 0 && Changes[i].NewlinesBefore == 0 && Changes[i - 1].Tok->is(tok::r_brace) && Changes[i - 1].StartOfTokenColumn == 0; bool WasAlignedWithStartOfNextLine = false; if (Changes[i].NewlinesBefore >= 1) { // A comment on its own line. unsigned CommentColumn = SourceMgr.getSpellingColumnNumber( Changes[i].OriginalWhitespaceRange.getEnd()); for (unsigned j = i + 1; j != e; ++j) { if (Changes[j].Tok->is(tok::comment)) continue; unsigned NextColumn = SourceMgr.getSpellingColumnNumber( Changes[j].OriginalWhitespaceRange.getEnd()); // The start of the next token was previously aligned with the // start of this comment. WasAlignedWithStartOfNextLine = CommentColumn == NextColumn || CommentColumn == NextColumn + Style.IndentWidth; break; } } if (Style.AlignTrailingComments.Kind == FormatStyle::TCAS_Never || FollowsRBraceInColumn0) { alignTrailingComments(StartOfSequence, i, MinColumn); MinColumn = ChangeMinColumn; MaxColumn = ChangeMinColumn; StartOfSequence = i; } else if (BreakBeforeNext || Newlines > NewLineThreshold || (ChangeMinColumn > MaxColumn || ChangeMaxColumn < MinColumn) || // Break the comment sequence if the previous line did not end // in a trailing comment. (Changes[i].NewlinesBefore == 1 && i > 0 && !Changes[i - 1].IsTrailingComment) || WasAlignedWithStartOfNextLine) { alignTrailingComments(StartOfSequence, i, MinColumn); MinColumn = ChangeMinColumn; MaxColumn = ChangeMaxColumn; StartOfSequence = i; } else { MinColumn = std::max(MinColumn, ChangeMinColumn); MaxColumn = std::min(MaxColumn, ChangeMaxColumn); } BreakBeforeNext = (i == 0) || (Changes[i].NewlinesBefore > 1) || // Never start a sequence with a comment at the beginning // of the line. (Changes[i].NewlinesBefore == 1 && StartOfSequence == i); Newlines = 0; } alignTrailingComments(StartOfSequence, Changes.size(), MinColumn); } void WhitespaceManager::alignTrailingComments(unsigned Start, unsigned End, unsigned Column) { for (unsigned i = Start; i != End; ++i) { int Shift = 0; if (Changes[i].IsTrailingComment) Shift = Column - Changes[i].StartOfTokenColumn; if (Changes[i].StartOfBlockComment) { Shift = Changes[i].IndentationOffset + Changes[i].StartOfBlockComment->StartOfTokenColumn - Changes[i].StartOfTokenColumn; } if (Shift <= 0) continue; Changes[i].Spaces += Shift; if (i + 1 != Changes.size()) Changes[i + 1].PreviousEndOfTokenColumn += Shift; Changes[i].StartOfTokenColumn += Shift; } } void WhitespaceManager::alignEscapedNewlines() { if (Style.AlignEscapedNewlines == FormatStyle::ENAS_DontAlign) return; bool AlignLeft = Style.AlignEscapedNewlines == FormatStyle::ENAS_Left; unsigned MaxEndOfLine = AlignLeft ? 0 : Style.ColumnLimit; unsigned StartOfMacro = 0; for (unsigned i = 1, e = Changes.size(); i < e; ++i) { Change &C = Changes[i]; if (C.NewlinesBefore > 0) { if (C.ContinuesPPDirective) { MaxEndOfLine = std::max(C.PreviousEndOfTokenColumn + 2, MaxEndOfLine); } else { alignEscapedNewlines(StartOfMacro + 1, i, MaxEndOfLine); MaxEndOfLine = AlignLeft ? 0 : Style.ColumnLimit; StartOfMacro = i; } } } alignEscapedNewlines(StartOfMacro + 1, Changes.size(), MaxEndOfLine); } void WhitespaceManager::alignEscapedNewlines(unsigned Start, unsigned End, unsigned Column) { for (unsigned i = Start; i < End; ++i) { Change &C = Changes[i]; if (C.NewlinesBefore > 0) { assert(C.ContinuesPPDirective); if (C.PreviousEndOfTokenColumn + 1 > Column) C.EscapedNewlineColumn = 0; else C.EscapedNewlineColumn = Column; } } } void WhitespaceManager::alignArrayInitializers() { if (Style.AlignArrayOfStructures == FormatStyle::AIAS_None) return; for (unsigned ChangeIndex = 1U, ChangeEnd = Changes.size(); ChangeIndex < ChangeEnd; ++ChangeIndex) { auto &C = Changes[ChangeIndex]; if (C.Tok->IsArrayInitializer) { bool FoundComplete = false; for (unsigned InsideIndex = ChangeIndex + 1; InsideIndex < ChangeEnd; ++InsideIndex) { if (Changes[InsideIndex].Tok == C.Tok->MatchingParen) { alignArrayInitializers(ChangeIndex, InsideIndex + 1); ChangeIndex = InsideIndex + 1; FoundComplete = true; break; } } if (!FoundComplete) ChangeIndex = ChangeEnd; } } } void WhitespaceManager::alignArrayInitializers(unsigned Start, unsigned End) { if (Style.AlignArrayOfStructures == FormatStyle::AIAS_Right) alignArrayInitializersRightJustified(getCells(Start, End)); else if (Style.AlignArrayOfStructures == FormatStyle::AIAS_Left) alignArrayInitializersLeftJustified(getCells(Start, End)); } void WhitespaceManager::alignArrayInitializersRightJustified( CellDescriptions &&CellDescs) { if (!CellDescs.isRectangular()) return; auto &Cells = CellDescs.Cells; // Now go through and fixup the spaces. auto *CellIter = Cells.begin(); for (auto i = 0U; i < CellDescs.CellCounts[0]; ++i, ++CellIter) { unsigned NetWidth = 0U; if (isSplitCell(*CellIter)) NetWidth = getNetWidth(Cells.begin(), CellIter, CellDescs.InitialSpaces); auto CellWidth = getMaximumCellWidth(CellIter, NetWidth); if (Changes[CellIter->Index].Tok->is(tok::r_brace)) { // So in here we want to see if there is a brace that falls // on a line that was split. If so on that line we make sure that // the spaces in front of the brace are enough. const auto *Next = CellIter; do { const FormatToken *Previous = Changes[Next->Index].Tok->Previous; if (Previous && Previous->isNot(TT_LineComment)) { Changes[Next->Index].Spaces = 0; Changes[Next->Index].NewlinesBefore = 0; } Next = Next->NextColumnElement; } while (Next); // Unless the array is empty, we need the position of all the // immediately adjacent cells if (CellIter != Cells.begin()) { auto ThisNetWidth = getNetWidth(Cells.begin(), CellIter, CellDescs.InitialSpaces); auto MaxNetWidth = getMaximumNetWidth( Cells.begin(), CellIter, CellDescs.InitialSpaces, CellDescs.CellCounts[0], CellDescs.CellCounts.size()); if (ThisNetWidth < MaxNetWidth) Changes[CellIter->Index].Spaces = (MaxNetWidth - ThisNetWidth); auto RowCount = 1U; auto Offset = std::distance(Cells.begin(), CellIter); for (const auto *Next = CellIter->NextColumnElement; Next != nullptr; Next = Next->NextColumnElement) { auto *Start = (Cells.begin() + RowCount * CellDescs.CellCounts[0]); auto *End = Start + Offset; ThisNetWidth = getNetWidth(Start, End, CellDescs.InitialSpaces); if (ThisNetWidth < MaxNetWidth) Changes[Next->Index].Spaces = (MaxNetWidth - ThisNetWidth); ++RowCount; } } } else { auto ThisWidth = calculateCellWidth(CellIter->Index, CellIter->EndIndex, true) + NetWidth; if (Changes[CellIter->Index].NewlinesBefore == 0) { Changes[CellIter->Index].Spaces = (CellWidth - (ThisWidth + NetWidth)); Changes[CellIter->Index].Spaces += (i > 0) ? 1 : 0; } alignToStartOfCell(CellIter->Index, CellIter->EndIndex); for (const auto *Next = CellIter->NextColumnElement; Next != nullptr; Next = Next->NextColumnElement) { ThisWidth = calculateCellWidth(Next->Index, Next->EndIndex, true) + NetWidth; if (Changes[Next->Index].NewlinesBefore == 0) { Changes[Next->Index].Spaces = (CellWidth - ThisWidth); Changes[Next->Index].Spaces += (i > 0) ? 1 : 0; } alignToStartOfCell(Next->Index, Next->EndIndex); } } } } void WhitespaceManager::alignArrayInitializersLeftJustified( CellDescriptions &&CellDescs) { if (!CellDescs.isRectangular()) return; auto &Cells = CellDescs.Cells; // Now go through and fixup the spaces. auto *CellIter = Cells.begin(); // The first cell needs to be against the left brace. if (Changes[CellIter->Index].NewlinesBefore == 0) Changes[CellIter->Index].Spaces = 0; else Changes[CellIter->Index].Spaces = CellDescs.InitialSpaces; ++CellIter; for (auto i = 1U; i < CellDescs.CellCounts[0]; i++, ++CellIter) { auto MaxNetWidth = getMaximumNetWidth( Cells.begin(), CellIter, CellDescs.InitialSpaces, CellDescs.CellCounts[0], CellDescs.CellCounts.size()); auto ThisNetWidth = getNetWidth(Cells.begin(), CellIter, CellDescs.InitialSpaces); if (Changes[CellIter->Index].NewlinesBefore == 0) { Changes[CellIter->Index].Spaces = MaxNetWidth - ThisNetWidth + (Changes[CellIter->Index].Tok->isNot(tok::r_brace) ? 1 : 0); } auto RowCount = 1U; auto Offset = std::distance(Cells.begin(), CellIter); for (const auto *Next = CellIter->NextColumnElement; Next != nullptr; Next = Next->NextColumnElement) { if (RowCount > CellDescs.CellCounts.size()) break; auto *Start = (Cells.begin() + RowCount * CellDescs.CellCounts[0]); auto *End = Start + Offset; auto ThisNetWidth = getNetWidth(Start, End, CellDescs.InitialSpaces); if (Changes[Next->Index].NewlinesBefore == 0) { Changes[Next->Index].Spaces = MaxNetWidth - ThisNetWidth + (Changes[Next->Index].Tok->isNot(tok::r_brace) ? 1 : 0); } ++RowCount; } } } bool WhitespaceManager::isSplitCell(const CellDescription &Cell) { if (Cell.HasSplit) return true; for (const auto *Next = Cell.NextColumnElement; Next != nullptr; Next = Next->NextColumnElement) { if (Next->HasSplit) return true; } return false; } WhitespaceManager::CellDescriptions WhitespaceManager::getCells(unsigned Start, unsigned End) { unsigned Depth = 0; unsigned Cell = 0; SmallVector CellCounts; unsigned InitialSpaces = 0; unsigned InitialTokenLength = 0; unsigned EndSpaces = 0; SmallVector Cells; const FormatToken *MatchingParen = nullptr; for (unsigned i = Start; i < End; ++i) { auto &C = Changes[i]; if (C.Tok->is(tok::l_brace)) ++Depth; else if (C.Tok->is(tok::r_brace)) --Depth; if (Depth == 2) { if (C.Tok->is(tok::l_brace)) { Cell = 0; MatchingParen = C.Tok->MatchingParen; if (InitialSpaces == 0) { InitialSpaces = C.Spaces + C.TokenLength; InitialTokenLength = C.TokenLength; auto j = i - 1; for (; Changes[j].NewlinesBefore == 0 && j > Start; --j) { InitialSpaces += Changes[j].Spaces + Changes[j].TokenLength; InitialTokenLength += Changes[j].TokenLength; } if (C.NewlinesBefore == 0) { InitialSpaces += Changes[j].Spaces + Changes[j].TokenLength; InitialTokenLength += Changes[j].TokenLength; } } } else if (C.Tok->is(tok::comma)) { if (!Cells.empty()) Cells.back().EndIndex = i; if (C.Tok->getNextNonComment()->isNot(tok::r_brace)) // dangling comma ++Cell; } } else if (Depth == 1) { if (C.Tok == MatchingParen) { if (!Cells.empty()) Cells.back().EndIndex = i; Cells.push_back(CellDescription{i, ++Cell, i + 1, false, nullptr}); CellCounts.push_back(C.Tok->Previous->isNot(tok::comma) ? Cell + 1 : Cell); // Go to the next non-comment and ensure there is a break in front const auto *NextNonComment = C.Tok->getNextNonComment(); while (NextNonComment->is(tok::comma)) NextNonComment = NextNonComment->getNextNonComment(); auto j = i; while (Changes[j].Tok != NextNonComment && j < End) ++j; if (j < End && Changes[j].NewlinesBefore == 0 && Changes[j].Tok->isNot(tok::r_brace)) { Changes[j].NewlinesBefore = 1; // Account for the added token lengths Changes[j].Spaces = InitialSpaces - InitialTokenLength; } } else if (C.Tok->is(tok::comment)) { // Trailing comments stay at a space past the last token C.Spaces = Changes[i - 1].Tok->is(tok::comma) ? 1 : 2; } else if (C.Tok->is(tok::l_brace)) { // We need to make sure that the ending braces is aligned to the // start of our initializer auto j = i - 1; for (; j > 0 && !Changes[j].Tok->ArrayInitializerLineStart; --j) ; // Nothing the loop does the work EndSpaces = Changes[j].Spaces; } } else if (Depth == 0 && C.Tok->is(tok::r_brace)) { C.NewlinesBefore = 1; C.Spaces = EndSpaces; } if (C.Tok->StartsColumn) { // This gets us past tokens that have been split over multiple // lines bool HasSplit = false; if (Changes[i].NewlinesBefore > 0) { // So if we split a line previously and the tail line + this token is // less then the column limit we remove the split here and just put // the column start at a space past the comma // // FIXME This if branch covers the cases where the column is not // the first column. This leads to weird pathologies like the formatting // auto foo = Items{ // Section{ // 0, bar(), // } // }; // Well if it doesn't lead to that it's indicative that the line // breaking should be revisited. Unfortunately alot of other options // interact with this auto j = i - 1; if ((j - 1) > Start && Changes[j].Tok->is(tok::comma) && Changes[j - 1].NewlinesBefore > 0) { --j; auto LineLimit = Changes[j].Spaces + Changes[j].TokenLength; if (LineLimit < Style.ColumnLimit) { Changes[i].NewlinesBefore = 0; Changes[i].Spaces = 1; } } } while (Changes[i].NewlinesBefore > 0 && Changes[i].Tok == C.Tok) { Changes[i].Spaces = InitialSpaces; ++i; HasSplit = true; } if (Changes[i].Tok != C.Tok) --i; Cells.push_back(CellDescription{i, Cell, i, HasSplit, nullptr}); } } return linkCells({Cells, CellCounts, InitialSpaces}); } unsigned WhitespaceManager::calculateCellWidth(unsigned Start, unsigned End, bool WithSpaces) const { unsigned CellWidth = 0; for (auto i = Start; i < End; i++) { if (Changes[i].NewlinesBefore > 0) CellWidth = 0; CellWidth += Changes[i].TokenLength; CellWidth += (WithSpaces ? Changes[i].Spaces : 0); } return CellWidth; } void WhitespaceManager::alignToStartOfCell(unsigned Start, unsigned End) { if ((End - Start) <= 1) return; // If the line is broken anywhere in there make sure everything // is aligned to the parent for (auto i = Start + 1; i < End; i++) if (Changes[i].NewlinesBefore > 0) Changes[i].Spaces = Changes[Start].Spaces; } WhitespaceManager::CellDescriptions WhitespaceManager::linkCells(CellDescriptions &&CellDesc) { auto &Cells = CellDesc.Cells; for (auto *CellIter = Cells.begin(); CellIter != Cells.end(); ++CellIter) { if (CellIter->NextColumnElement == nullptr && ((CellIter + 1) != Cells.end())) { for (auto *NextIter = CellIter + 1; NextIter != Cells.end(); ++NextIter) { if (NextIter->Cell == CellIter->Cell) { CellIter->NextColumnElement = &(*NextIter); break; } } } } return std::move(CellDesc); } void WhitespaceManager::generateChanges() { for (unsigned i = 0, e = Changes.size(); i != e; ++i) { const Change &C = Changes[i]; if (i > 0 && Changes[i - 1].OriginalWhitespaceRange.getBegin() == C.OriginalWhitespaceRange.getBegin()) { // Do not generate two replacements for the same location. continue; } if (C.CreateReplacement) { std::string ReplacementText = C.PreviousLinePostfix; if (C.ContinuesPPDirective) { appendEscapedNewlineText(ReplacementText, C.NewlinesBefore, C.PreviousEndOfTokenColumn, C.EscapedNewlineColumn); } else { appendNewlineText(ReplacementText, C.NewlinesBefore); } // FIXME: This assert should hold if we computed the column correctly. // assert((int)C.StartOfTokenColumn >= C.Spaces); appendIndentText( ReplacementText, C.Tok->IndentLevel, std::max(0, C.Spaces), std::max((int)C.StartOfTokenColumn, C.Spaces) - std::max(0, C.Spaces), C.IsAligned); ReplacementText.append(C.CurrentLinePrefix); storeReplacement(C.OriginalWhitespaceRange, ReplacementText); } } } void WhitespaceManager::storeReplacement(SourceRange Range, StringRef Text) { unsigned WhitespaceLength = SourceMgr.getFileOffset(Range.getEnd()) - SourceMgr.getFileOffset(Range.getBegin()); // Don't create a replacement, if it does not change anything. if (StringRef(SourceMgr.getCharacterData(Range.getBegin()), WhitespaceLength) == Text) { return; } auto Err = Replaces.add(tooling::Replacement( SourceMgr, CharSourceRange::getCharRange(Range), Text)); // FIXME: better error handling. For now, just print an error message in the // release version. if (Err) { llvm::errs() << llvm::toString(std::move(Err)) << "\n"; assert(false); } } void WhitespaceManager::appendNewlineText(std::string &Text, unsigned Newlines) { if (UseCRLF) { Text.reserve(Text.size() + 2 * Newlines); for (unsigned i = 0; i < Newlines; ++i) Text.append("\r\n"); } else { Text.append(Newlines, '\n'); } } void WhitespaceManager::appendEscapedNewlineText( std::string &Text, unsigned Newlines, unsigned PreviousEndOfTokenColumn, unsigned EscapedNewlineColumn) { if (Newlines > 0) { unsigned Spaces = std::max(1, EscapedNewlineColumn - PreviousEndOfTokenColumn - 1); for (unsigned i = 0; i < Newlines; ++i) { Text.append(Spaces, ' '); Text.append(UseCRLF ? "\\\r\n" : "\\\n"); Spaces = std::max(0, EscapedNewlineColumn - 1); } } } void WhitespaceManager::appendIndentText(std::string &Text, unsigned IndentLevel, unsigned Spaces, unsigned WhitespaceStartColumn, bool IsAligned) { switch (Style.UseTab) { case FormatStyle::UT_Never: Text.append(Spaces, ' '); break; case FormatStyle::UT_Always: { if (Style.TabWidth) { unsigned FirstTabWidth = Style.TabWidth - WhitespaceStartColumn % Style.TabWidth; // Insert only spaces when we want to end up before the next tab. if (Spaces < FirstTabWidth || Spaces == 1) { Text.append(Spaces, ' '); break; } // Align to the next tab. Spaces -= FirstTabWidth; Text.append("\t"); Text.append(Spaces / Style.TabWidth, '\t'); Text.append(Spaces % Style.TabWidth, ' '); } else if (Spaces == 1) { Text.append(Spaces, ' '); } break; } case FormatStyle::UT_ForIndentation: if (WhitespaceStartColumn == 0) { unsigned Indentation = IndentLevel * Style.IndentWidth; Spaces = appendTabIndent(Text, Spaces, Indentation); } Text.append(Spaces, ' '); break; case FormatStyle::UT_ForContinuationAndIndentation: if (WhitespaceStartColumn == 0) Spaces = appendTabIndent(Text, Spaces, Spaces); Text.append(Spaces, ' '); break; case FormatStyle::UT_AlignWithSpaces: if (WhitespaceStartColumn == 0) { unsigned Indentation = IsAligned ? IndentLevel * Style.IndentWidth : Spaces; Spaces = appendTabIndent(Text, Spaces, Indentation); } Text.append(Spaces, ' '); break; } } unsigned WhitespaceManager::appendTabIndent(std::string &Text, unsigned Spaces, unsigned Indentation) { // This happens, e.g. when a line in a block comment is indented less than the // first one. if (Indentation > Spaces) Indentation = Spaces; if (Style.TabWidth) { unsigned Tabs = Indentation / Style.TabWidth; Text.append(Tabs, '\t'); Spaces -= Tabs * Style.TabWidth; } return Spaces; } } // namespace format } // namespace clang