1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441 |
- //===--- 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 <algorithm>
- 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<bool, 16> 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.
- template <typename F>
- static void
- AlignTokenSequence(const FormatStyle &Style, unsigned Start, unsigned End,
- unsigned Column, F &&Matches,
- SmallVector<WhitespaceManager::Change, 16> &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<unsigned, 16> 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 - Changes[i].StartOfTokenColumn;
- Changes[i].Spaces += Shift;
- }
- // 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;
- 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 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;
- }
- return true;
- }
- return false;
- };
- if (ShouldShiftBeAdded())
- Changes[i].Spaces += Shift;
- }
- if (ContinuedStringLiteral)
- Changes[i].Spaces += Shift;
- 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.
- template <typename F>
- static unsigned AlignTokens(
- const FormatStyle &Style, F &&Matches,
- SmallVector<WhitespaceManager::Change, 16> &Changes, unsigned StartAt,
- const FormatStyle::AlignConsecutiveStyle &ACS = FormatStyle::ACS_None) {
- unsigned MinColumn = 0;
- unsigned MaxColumn = UINT_MAX;
- // 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<unsigned, unsigned, unsigned>();
- // 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, MinColumn,
- Matches, Changes);
- MinColumn = 0;
- MaxColumn = UINT_MAX;
- StartOfSequence = 0;
- EndOfSequence = 0;
- };
- unsigned i = StartAt;
- for (unsigned e = Changes.size(); i != e; ++i) {
- if (Changes[i].indentAndNestingLevel() < IndentAndNestingLevel)
- break;
- 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 != FormatStyle::ACS_AcrossEmptyLines) &&
- (ACS != FormatStyle::ACS_AcrossEmptyLinesAndComments);
- // Whether to break the alignment sequence because of a line without a
- // match.
- bool NoMatchBreak =
- !FoundMatchOnLine &&
- !(LineIsComment &&
- ((ACS == FormatStyle::ACS_AcrossComments) ||
- (ACS == FormatStyle::ACS_AcrossEmptyLinesAndComments)));
- 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);
- 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 ChangeMinColumn = Changes[i].StartOfTokenColumn;
- int LineLengthAfter = Changes[i].TokenLength;
- for (unsigned j = i + 1; j != e && Changes[j].NewlinesBefore == 0; ++j) {
- LineLengthAfter += 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)
- LineLengthAfter += Changes[j].TokenLength;
- }
- unsigned ChangeMaxColumn = Style.ColumnLimit - LineLengthAfter;
- // If we are restricted by the maximum column width, end the sequence.
- if (ChangeMinColumn > MaxColumn || ChangeMaxColumn < MinColumn ||
- CommasBeforeLastMatch != CommasBeforeMatch) {
- AlignCurrentSequence();
- StartOfSequence = i;
- }
- MinColumn = std::max(MinColumn, ChangeMinColumn);
- MaxColumn = std::min(MaxColumn, ChangeMaxColumn);
- }
- 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<bool(const WhitespaceManager::Change &C)> AlignMacrosMatches,
- SmallVector<WhitespaceManager::Change, 16> &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 == FormatStyle::ACS_None)
- 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 != FormatStyle::ACS_AcrossEmptyLines) &&
- (Style.AlignConsecutiveMacros !=
- FormatStyle::ACS_AcrossEmptyLinesAndComments);
- // Whether to break the alignment sequence because of a line without a
- // match.
- bool NoMatchBreak =
- !FoundMatchOnLine &&
- !(LineIsComment && ((Style.AlignConsecutiveMacros ==
- FormatStyle::ACS_AcrossComments) ||
- (Style.AlignConsecutiveMacros ==
- FormatStyle::ACS_AcrossEmptyLinesAndComments)));
- 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 == FormatStyle::ACS_None)
- 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 C.Tok->is(tok::equal);
- },
- Changes, /*StartAt=*/0, Style.AlignConsecutiveAssignments);
- }
- void WhitespaceManager::alignConsecutiveBitFields() {
- if (Style.AlignConsecutiveBitFields == FormatStyle::ACS_None)
- 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 == FormatStyle::ACS_None)
- return;
- AlignTokens(
- Style,
- [](Change const &C) {
- // tok::kw_operator is necessary for aligning operator overload
- // definitions.
- if (C.Tok->isOneOf(TT_FunctionDeclarationName, tok::kw_operator))
- 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;
- for (unsigned i = 0, e = Changes.size(); i != e; ++i) {
- if (Changes[i].StartOfBlockComment)
- continue;
- Newlines += Changes[i].NewlinesBefore;
- if (!Changes[i].IsTrailingComment)
- 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 || FollowsRBraceInColumn0) {
- alignTrailingComments(StartOfSequence, i, MinColumn);
- MinColumn = ChangeMinColumn;
- MaxColumn = ChangeMinColumn;
- StartOfSequence = i;
- } else if (BreakBeforeNext || Newlines > 1 ||
- (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) {
- auto &Cells = CellDescs.Cells;
- // Now go through and fixup the spaces.
- auto *CellIter = Cells.begin();
- for (auto i = 0U; i < CellDescs.CellCount; ++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.
- Changes[CellIter->Index].NewlinesBefore = 0;
- Changes[CellIter->Index].Spaces = 0;
- for (const auto *Next = CellIter->NextColumnElement; Next != nullptr;
- Next = Next->NextColumnElement) {
- Changes[Next->Index].Spaces = 0;
- Changes[Next->Index].NewlinesBefore = 0;
- }
- // 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.CellCount);
- 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.CellCount);
- 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) {
- 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.CellCount; i++, ++CellIter) {
- auto MaxNetWidth = getMaximumNetWidth(
- Cells.begin(), CellIter, CellDescs.InitialSpaces, CellDescs.CellCount);
- 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) {
- auto *Start = (Cells.begin() + RowCount * CellDescs.CellCount);
- 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;
- unsigned CellCount = 0;
- unsigned InitialSpaces = 0;
- unsigned InitialTokenLength = 0;
- unsigned EndSpaces = 0;
- SmallVector<CellDescription> 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});
- CellCount = 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, CellCount, 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<int>(1, EscapedNewlineColumn - PreviousEndOfTokenColumn - 1);
- for (unsigned i = 0; i < Newlines; ++i) {
- Text.append(Spaces, ' ');
- Text.append(UseCRLF ? "\\\r\n" : "\\\n");
- Spaces = std::max<int>(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
|