Namespaces
	encoding

	internal

Classes
struct	AdditionalKeywords
	Encapsulates keywords that are context sensitive or for languages not properly supported by Clang's lexer. More...

class	AffectedRangeManager

class	AnnotatedLine

class	BreakableBlockComment

class	BreakableComment

class	BreakableLineCommentSection

class	BreakableStringLiteral

class	CommaSeparatedList

class	CompoundStatementIndenter

class	ContinuationIndenter

class	Environment

struct	FormatStyle
	The `FormatStyle` is used to configure the formatting to follow specific guidelines. More...

struct	FormattingAttemptStatus
	Represents the status of a formatting attempt. More...

struct	FormatToken
	A wrapper around a `Token` storing information about the whitespace characters preceding it. More...

class	FormatTokenLexer

class	FormatTokenSource

class	JavaScriptImportSorter

struct	JsImportedSymbol

struct	JsModuleReference

struct	LineState
	The current state when indenting a unwrapped line. More...

class	NamespaceEndCommentsFixer

struct	ParenState

class	ParseErrorCategory

struct	RawStringFormatStyleManager

class	ScopedLineState

class	TokenAnalyzer

class	TokenAnnotator
	Determines extra information about the tokens comprising an `UnwrappedLine`. More...

class	TokenRole

struct	UnwrappedLine
	An unwrapped line is a sequence of `Token`, that we would like to put on a single line if there was no column limit. More...

class	UnwrappedLineConsumer

class	UnwrappedLineFormatter

struct	UnwrappedLineNode

class	UnwrappedLineParser

class	UsingDeclarationsSorter

class	WhitespaceManager
	Manages the whitespaces around tokens and their replacements. More...

Enumerations
enum	ParseError { ParseError::Success = 0, ParseError::Error, ParseError::Unsuitable }

enum	TokenType { NUM_TOKEN_TYPES }

enum	BraceBlockKind { BK_Unknown, BK_Block, BK_BracedInit }

enum	ParameterPackingKind { PPK_BinPacked, PPK_OnePerLine, PPK_Inconclusive }

enum	FormatDecision { FD_Unformatted, FD_Continue, FD_Break }

enum	LexerState { NORMAL, TEMPLATE_STRING, TOKEN_STASHED }

enum	LineType { LT_Invalid, LT_ImportStatement, LT_ObjCDecl, LT_ObjCMethodDecl, LT_ObjCProperty, LT_Other, LT_PreprocessorDirective, LT_VirtualFunctionDecl }

Functions
const std::error_category &	getParseCategory ()

std::error_code	make_error_code (ParseError e)

FormatStyle	getLLVMStyle (FormatStyle::LanguageKind Language=FormatStyle::LanguageKind::LK_Cpp)
	Returns a format style complying with the LLVM coding standards: http://llvm.org/docs/CodingStandards.html. More...

FormatStyle	getGoogleStyle (FormatStyle::LanguageKind Language)
	Returns a format style complying with one of Google's style guides: http://google-styleguide.googlecode.com/svn/trunk/cppguide.xml. More...

FormatStyle	getChromiumStyle (FormatStyle::LanguageKind Language)
	Returns a format style complying with Chromium's style guide: http://www.chromium.org/developers/coding-style. More...

FormatStyle	getMozillaStyle ()
	Returns a format style complying with Mozilla's style guide: https://developer.mozilla.org/en-US/docs/Developer_Guide/Coding_Style. More...

FormatStyle	getWebKitStyle ()
	Returns a format style complying with Webkit's style guide: http://www.webkit.org/coding/coding-style.html. More...

FormatStyle	getGNUStyle ()
	Returns a format style complying with GNU Coding Standards: http://www.gnu.org/prep/standards/standards.html. More...

FormatStyle	getMicrosoftStyle (FormatStyle::LanguageKind Language)
	Returns a format style complying with Microsoft style guide: https://docs.microsoft.com/en-us/visualstudio/ide/editorconfig-code-style-settings-reference?view=vs-2017. More...

FormatStyle	getNoStyle ()
	Returns style indicating formatting should be not applied at all. More...

bool	getPredefinedStyle (StringRef Name, FormatStyle::LanguageKind Language, FormatStyle *Style)
	Gets a predefined style for the specified language by name. More...

std::error_code	parseConfiguration (StringRef Text, FormatStyle *Style)
	Parse configuration from YAML-formatted text. More...

std::string	configurationAsText (const FormatStyle &Style)
	Gets configuration in a YAML string. More...

tooling::Replacements	sortIncludes (const FormatStyle &Style, StringRef Code, ArrayRef< tooling::Range > Ranges, StringRef FileName, unsigned *Cursor=nullptr)
	Returns the replacements necessary to sort all `#include` blocks that are affected by `Ranges`. More...

llvm::Expected< tooling::Replacements >	formatReplacements (StringRef Code, const tooling::Replacements &Replaces, const FormatStyle &Style)
	Returns the replacements corresponding to applying and formatting `Replaces` on success; otheriwse, return an llvm::Error carrying llvm::StringError. More...

llvm::Expected< tooling::Replacements >	cleanupAroundReplacements (StringRef Code, const tooling::Replacements &Replaces, const FormatStyle &Style)
	Returns the replacements corresponding to applying `Replaces` and cleaning up the code after that on success; otherwise, return an llvm::Error carrying llvm::StringError. More...

tooling::Replacements	reformat (const FormatStyle &Style, StringRef Code, ArrayRef< tooling::Range > Ranges, StringRef FileName="<stdin>", FormattingAttemptStatus *Status=nullptr)
	Reformats the given `Ranges` in `Code`. More...

tooling::Replacements	reformat (const FormatStyle &Style, StringRef Code, ArrayRef< tooling::Range > Ranges, StringRef FileName, bool *IncompleteFormat)
	Same as above, except if `IncompleteFormat` is non-null, its value will be set to true if any of the affected ranges were not formatted due to a non-recoverable syntax error. More...

tooling::Replacements	cleanup (const FormatStyle &Style, StringRef Code, ArrayRef< tooling::Range > Ranges, StringRef FileName="<stdin>")
	Clean up any erroneous/redundant code in the given `Ranges` in `Code`. More...

tooling::Replacements	fixNamespaceEndComments (const FormatStyle &Style, StringRef Code, ArrayRef< tooling::Range > Ranges, StringRef FileName="<stdin>")
	Fix namespace end comments in the given `Ranges` in `Code`. More...

tooling::Replacements	sortUsingDeclarations (const FormatStyle &Style, StringRef Code, ArrayRef< tooling::Range > Ranges, StringRef FileName="<stdin>")
	Sort consecutive using declarations in the given `Ranges` in `Code`. More...

LangOptions	getFormattingLangOpts (const FormatStyle &Style=getLLVMStyle())
	Returns the `LangOpts` that the formatter expects you to set. More...

llvm::Expected< FormatStyle >	getStyle (StringRef StyleName, StringRef FileName, StringRef FallbackStyle, StringRef Code="", llvm::vfs::FileSystem *FS=nullptr)
	Construct a FormatStyle based on `StyleName`. More...

FormatStyle::LanguageKind	guessLanguage (StringRef FileName, StringRef Code)

StringRef	getLanguageName (FormatStyle::LanguageKind Language)

static bool	IsBlank (char C)

static StringRef	getLineCommentIndentPrefix (StringRef Comment, const FormatStyle &Style)

static BreakableToken::Split	getCommentSplit (StringRef Text, unsigned ContentStartColumn, unsigned ColumnLimit, unsigned TabWidth, encoding::Encoding Encoding, const FormatStyle &Style, bool DecorationEndsWithStar=false)

static BreakableToken::Split	getStringSplit (StringRef Text, unsigned UsedColumns, unsigned ColumnLimit, unsigned TabWidth, encoding::Encoding Encoding)

bool	switchesFormatting (const FormatToken &Token)
	Checks if `Token` switches formatting, like /* clang-format off. More...

static bool	mayReflowContent (StringRef Content)

virtual	~BreakableToken ()

virtual unsigned	getLineCount () const =0
	Returns the number of lines in this token in the original code. More...

virtual unsigned	getRangeLength (unsigned LineIndex, unsigned Offset, StringRef::size_type Length, unsigned StartColumn) const =0
	Returns the number of columns required to format the text in the byte range [`Offset`, `Offset` `+` `Length`). More...

virtual unsigned	getRemainingLength (unsigned LineIndex, unsigned Offset, unsigned StartColumn) const
	Returns the number of columns required to format the text following the byte `Offset` in the line `LineIndex`, including potentially unbreakable sequences of tokens following after the end of the token. More...

virtual unsigned	getContentStartColumn (unsigned LineIndex, bool Break) const =0
	Returns the column at which content in line `LineIndex` starts, assuming no reflow. More...

virtual unsigned	getContentIndent (unsigned LineIndex) const
	Returns additional content indent required for the second line after the content at line `LineIndex` is broken. More...

virtual Split	getSplit (unsigned LineIndex, unsigned TailOffset, unsigned ColumnLimit, unsigned ContentStartColumn, llvm::Regex &CommentPragmasRegex) const =0
	Returns a range (offset, length) at which to break the line at `LineIndex`, if previously broken at `TailOffset`. More...

virtual void	insertBreak (unsigned LineIndex, unsigned TailOffset, Split Split, unsigned ContentIndent, WhitespaceManager &Whitespaces) const =0
	Emits the previously retrieved `Split` via `Whitespaces`. More...

unsigned	getLengthAfterCompression (unsigned RemainingTokenColumns, Split Split) const
	Returns the number of columns needed to format `RemainingTokenColumns`, assuming that Split is within the range measured by `RemainingTokenColumns`, and that the whitespace in Split is reduced to a single space. More...

virtual void	compressWhitespace (unsigned LineIndex, unsigned TailOffset, Split Split, WhitespaceManager &Whitespaces) const =0
	Replaces the whitespace range described by `Split` with a single space. More...

virtual bool	supportsReflow () const
	Returns whether the token supports reflowing text. More...

virtual Split	getReflowSplit (unsigned LineIndex, llvm::Regex &CommentPragmasRegex) const
	Returns a whitespace range (offset, length) of the content at `LineIndex` such that the content of that line is reflown to the end of the previous one. More...

virtual void	reflow (unsigned LineIndex, WhitespaceManager &Whitespaces) const
	Reflows the current line into the end of the previous one. More...

virtual bool	introducesBreakBeforeToken () const
	Returns whether there will be a line break at the start of the token. More...

virtual void	adaptStartOfLine (unsigned LineIndex, WhitespaceManager &Whitespaces) const
	Replaces the whitespace between `LineIndex-1` and `LineIndex`. More...

virtual Split	getSplitAfterLastLine (unsigned TailOffset) const
	Returns a whitespace range (offset, length) of the content at the last line that needs to be reformatted after the last line has been reformatted. More...

void	replaceWhitespaceAfterLastLine (unsigned TailOffset, Split SplitAfterLastLine, WhitespaceManager &Whitespaces) const
	Replaces the whitespace from `SplitAfterLastLine` on the last line after the last line has been formatted by performing a reformatting. More...

virtual void	updateNextToken (LineState &State) const
	Updates the next token of `State` to the next token after this one. More...

	BreakableToken (const FormatToken &Tok, bool InPPDirective, encoding::Encoding Encoding, const FormatStyle &Style)

static bool	shouldIndentWrappedSelectorName (const FormatStyle &Style, LineType LineType)

static unsigned	getLengthToMatchingParen (const FormatToken &Tok, const std::vector< ParenState > &Stack)

static unsigned	getLengthToNextOperator (const FormatToken &Tok)

static bool	startsSegmentOfBuilderTypeCall (const FormatToken &Tok)

static bool	startsNextParameter (const FormatToken &Current, const FormatStyle &Style)

static bool	opensProtoMessageField (const FormatToken &LessTok, const FormatStyle &Style)

static llvm::Optional< StringRef >	getRawStringDelimiter (StringRef TokenText)

static StringRef	getCanonicalRawStringDelimiter (const FormatStyle &Style, FormatStyle::LanguageKind Language)

static unsigned	getLastLineEndColumn (StringRef Text, unsigned StartColumn, unsigned TabWidth, encoding::Encoding Encoding)

static StringRef	getEnclosingFunctionName (const FormatToken &Current)

llvm::Error	make_string_error (const llvm::Twine &Message)

static FormatStyle	expandPresets (const FormatStyle &Style)

static bool	affectsRange (ArrayRef< tooling::Range > Ranges, unsigned Start, unsigned End)

static std::pair< unsigned, unsigned >	FindCursorIndex (const SmallVectorImpl< IncludeDirective > &Includes, const SmallVectorImpl< unsigned > &Indices, unsigned Cursor)

std::string	replaceCRLF (const std::string &Code)

static void	sortCppIncludes (const FormatStyle &Style, const SmallVectorImpl< IncludeDirective > &Includes, ArrayRef< tooling::Range > Ranges, StringRef FileName, StringRef Code, tooling::Replacements &Replaces, unsigned *Cursor)

tooling::Replacements	sortCppIncludes (const FormatStyle &Style, StringRef Code, ArrayRef< tooling::Range > Ranges, StringRef FileName, tooling::Replacements &Replaces, unsigned *Cursor)

static unsigned	findJavaImportGroup (const FormatStyle &Style, StringRef ImportIdentifier)

static void	sortJavaImports (const FormatStyle &Style, const SmallVectorImpl< JavaImportDirective > &Imports, ArrayRef< tooling::Range > Ranges, StringRef FileName, StringRef Code, tooling::Replacements &Replaces)

tooling::Replacements	sortJavaImports (const FormatStyle &Style, StringRef Code, ArrayRef< tooling::Range > Ranges, StringRef FileName, tooling::Replacements &Replaces)

bool	isMpegTS (StringRef Code)

bool	isLikelyXml (StringRef Code)

template<typename T >
static llvm::Expected< tooling::Replacements >	processReplacements (T ProcessFunc, StringRef Code, const tooling::Replacements &Replaces, const FormatStyle &Style)

static FormatStyle::LanguageKind	getLanguageByFileName (StringRef FileName)

const char *	getTokenTypeName (TokenType Type)
	Determines the name of a token type. More...

static unsigned	CodePointsBetween (const FormatToken Begin, const FormatToken End)

const FormatToken *	getNamespaceToken (const AnnotatedLine Line, const SmallVectorImpl< AnnotatedLine > &AnnotatedLines)

StringRef	getNamespaceTokenText (const AnnotatedLine Line, const SmallVectorImpl< AnnotatedLine > &AnnotatedLines)

bool	operator< (const JsModuleReference &LHS, const JsModuleReference &RHS)

tooling::Replacements	sortJavaScriptImports (const FormatStyle &Style, StringRef Code, ArrayRef< tooling::Range > Ranges, StringRef FileName)

static unsigned	maxNestingDepth (const AnnotatedLine &Line)

static bool	isFunctionDeclarationName (const FormatToken &Current, const AnnotatedLine &Line)

static bool	isAllmanBrace (const FormatToken &Tok)

template<class T >
static void	hash_combine (std::size_t &seed, const T &v)

static bool	isGoogScope (const UnwrappedLine &Line)

static bool	isIIFE (const UnwrappedLine &Line, const AdditionalKeywords &Keywords)

static bool	ShouldBreakBeforeBrace (const FormatStyle &Style, const FormatToken &InitialToken)

static bool	tokenCanStartNewLine (const clang::Token &Tok)

static bool	mustBeJSIdent (const AdditionalKeywords &Keywords, const FormatToken *FormatTok)

static bool	mustBeJSIdentOrValue (const AdditionalKeywords &Keywords, const FormatToken *FormatTok)

static bool	isJSDeclOrStmt (const AdditionalKeywords &Keywords, const FormatToken *FormatTok)

static LLVM_ATTRIBUTE_UNUSED void	printDebugInfo (const UnwrappedLine &Line, StringRef Prefix="")

static bool	continuesLineCommentSection (const FormatToken &FormatTok, const UnwrappedLine &Line, llvm::Regex &CommentPragmasRegex)

template<typename F >
static void	AlignTokenSequence (unsigned Start, unsigned End, unsigned Column, F &&Matches, SmallVector< WhitespaceManager::Change, 16 > &Changes)

template<typename F >
static unsigned	AlignTokens (const FormatStyle &Style, F &&Matches, SmallVector< WhitespaceManager::Change, 16 > &Changes, unsigned StartAt)

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)

Variables
const char *	StyleOptionHelpDescription
	Description to be used for help text for a `llvm::cl` option for specifying format style. More...

const char *	DefaultFormatStyle = "file"
	The suggested format style to use by default. More...

const char *	DefaultFallbackStyle = "LLVM"
	The suggested predefined style to use as the fallback style in `getStyle`. More...

static const char *const	Blanks = " \t\v\f\r"

to be on a line of	itself
	Base class for tokens / ranges of tokens that can allow breaking within the tokens - for example, to avoid whitespace beyond the column limit, or to reflow text. More...

to be on a line of there are analogous operations *that might be executed after the last line has been	reformatted

to be on a line of there are analogous operations that might be executed after the last line has been for finding a split after the last line that needs to be	reflown

to be on a line of there are analogous operations that might be executed after the last line has been for finding a split after the last line that needs to be *	replaceWhitespaceAfterLastLine

const FormatToken &	Tok

const bool	InPPDirective

const encoding::Encoding	Encoding

const FormatStyle &	Style

Enumeration Type Documentation

◆ BraceBlockKind

enum clang::format::BraceBlockKind

Enumerator
BK_Unknown
BK_Block
BK_BracedInit

Definition at line 117 of file FormatToken.h.

◆ FormatDecision

enum clang::format::FormatDecision

Enumerator
FD_Unformatted
FD_Continue
FD_Break

Definition at line 122 of file FormatToken.h.

◆ LexerState

enum clang::format::LexerState

Enumerator
NORMAL
TEMPLATE_STRING
TOKEN_STASHED

Definition at line 31 of file FormatTokenLexer.h.

◆ LineType

enum clang::format::LineType

Enumerator
LT_Invalid
LT_ImportStatement
LT_ObjCDecl
LT_ObjCMethodDecl
LT_ObjCProperty
LT_Other
LT_PreprocessorDirective
LT_VirtualFunctionDecl

Definition at line 26 of file TokenAnnotator.h.

◆ ParameterPackingKind

enum clang::format::ParameterPackingKind

Enumerator
PPK_BinPacked
PPK_OnePerLine
PPK_Inconclusive

Definition at line 120 of file FormatToken.h.

◆ ParseError

enum clang::format::ParseError

strong

Enumerator
Success
Error
Unsuitable

Definition at line 38 of file Format.h.

◆ TokenType

enum clang::format::TokenType

Enumerator
NUM_TOKEN_TYPES

Definition at line 106 of file FormatToken.h.

Function Documentation

◆ adaptStartOfLine()

virtual void clang::format::adaptStartOfLine	(	unsigned	LineIndex,
		WhitespaceManager &	Whitespaces
	)		const

virtual

Replaces the whitespace between LineIndex-1 and LineIndex.

Definition at line 206 of file BreakableToken.h.

◆ affectsRange()

static bool clang::format::affectsRange	(	ArrayRef< tooling::Range >	Ranges,
		unsigned	Start,
		unsigned	End
	)

static

Definition at line 1825 of file Format.cpp.

Referenced by sortCppIncludes(), and sortJavaImports().

◆ AlignMacroSequence()

static void clang::format::AlignMacroSequence	(	unsigned &	StartOfSequence,
		unsigned &	EndOfSequence,
		unsigned &	MinColumn,
		unsigned &	MaxColumn,
		bool &	FoundMatchOnLine,
		std::function< bool(const WhitespaceManager::Change &C)>	AlignMacrosMatches,
		SmallVector< WhitespaceManager::Change, 16 > &	Changes
	)

static

Definition at line 439 of file WhitespaceManager.cpp.

References clang::format::FormatStyle::AlignConsecutiveMacros, clang::format::WhitespaceManager::Change::Change(), clang::format::WhitespaceManager::Change::NewlinesBefore, clang::format::WhitespaceManager::Change::PreviousEndOfTokenColumn, clang::prec::Shift, Style, and UINT_MAX.

◆ AlignTokens()

template<typename F >

static unsigned clang::format::AlignTokens	(	const FormatStyle &	Style,
		F &&	Matches,
		SmallVector< WhitespaceManager::Change, 16 > &	Changes,
		unsigned	StartAt
	)

static

Definition at line 329 of file WhitespaceManager.cpp.

◆ AlignTokenSequence()

template<typename F >

static void clang::format::AlignTokenSequence	(	unsigned	Start,
		unsigned	End,
		unsigned	Column,
		F &&	Matches,
		SmallVector< WhitespaceManager::Change, 16 > &	Changes
	)

static

Definition at line 234 of file WhitespaceManager.cpp.

◆ BreakableToken()

clang::format::BreakableToken	(	const FormatToken &	Tok,
		bool	InPPDirective,
		encoding::Encoding	Encoding,
		const FormatStyle &	Style
	)

protected

Definition at line 234 of file BreakableToken.h.

◆ cleanup()

tooling::Replacements clang::format::cleanup	(	const FormatStyle &	Style,
		StringRef	Code,
		ArrayRef< tooling::Range >	Ranges,
		StringRef	FileName = `"<stdin>"`
	)

Clean up any erroneous/redundant code in the given Ranges in Code.

Returns the Replacements that clean up all Ranges in Code.

Definition at line 2454 of file Format.cpp.

Referenced by cleanupAroundReplacements(), clang::CodeGen::EHScopeStack::containsOnlyLifetimeMarkers(), clang::CodeGen::CodeGenFunction::EmitAnyExprToExn(), clang::CodeGen::EHScopeStack::getInnermostActiveNormalCleanup(), clang::CodeGen::CodeGenFunction::initFullExprCleanupWithFlag(), isSimpleZero(), isTrivialFiller(), IsUsedAsEHCleanup(), clang::CodeGen::EHScopeStack::requiresLandingPad(), and clang::CodeGen::CGBlockInfo::Capture::setCleanup().

◆ cleanupAroundReplacements()

llvm::Expected< tooling::Replacements > clang::format::cleanupAroundReplacements	(	StringRef	Code,
		const tooling::Replacements &	Replaces,
		const FormatStyle &	Style
	)

Returns the replacements corresponding to applying Replaces and cleaning up the code after that on success; otherwise, return an llvm::Error carrying llvm::StringError.

This also supports inserting/deleting C++ #include directives:

If a replacement has offset UINT_MAX, length 0, and a replacement text that is an #include directive, this will insert the #include into the correct block in the Code.
If a replacement has offset UINT_MAX, length 1, and a replacement text that is the name of the header to be removed, the header will be removed from Code if it exists. The include manipulation is done via tooling::HeaderInclude, see its documentation for more details on how include insertion points are found and what edits are produced.

Definition at line 2360 of file Format.cpp.

References cleanup(), processReplacements(), and Style.

Referenced by clang::tooling::applyAtomicChanges(), and llvm::yaml::MappingTraits< clang::tooling::AtomicChange >::mapping().

◆ CodePointsBetween()

static unsigned clang::format::CodePointsBetween	(	const FormatToken *	Begin,
		const FormatToken *	End
	)

static

Definition at line 145 of file FormatToken.cpp.

References clang::format::FormatToken::ColumnWidth, and clang::format::FormatToken::TotalLength.

Referenced by clang::format::CommaSeparatedList::precomputeFormattingInfos().

◆ compressWhitespace()

virtual void clang::format::compressWhitespace	(	unsigned	LineIndex,
		unsigned	TailOffset,
		Split	Split,
		WhitespaceManager &	Whitespaces
	)		const

pure virtual

Replaces the whitespace range described by Split with a single space.

Referenced by clang::format::BreakableComment::supportsReflow().

◆ configurationAsText()

std::string clang::format::configurationAsText ( const FormatStyle & Style )

Gets configuration in a YAML string.

Definition at line 1201 of file Format.cpp.

References clang::interp::Add(), expandPresets(), Style, and Text.

◆ continuesLineCommentSection()

static bool clang::format::continuesLineCommentSection	(	const FormatToken &	FormatTok,
		const UnwrappedLine &	Line,
		llvm::Regex &	CommentPragmasRegex
	)

static

Definition at line 2501 of file UnwrappedLineParser.cpp.

References clang::format::UnwrappedLine::Tokens, and clang::format::FormatToken::TokenText.

◆ expandPresets()

static FormatStyle clang::format::expandPresets ( const FormatStyle & Style )

static

Definition at line 642 of file Format.cpp.

References Style.

Referenced by configurationAsText().

◆ FindCursorIndex()

static std::pair<unsigned, unsigned> clang::format::FindCursorIndex	(	const SmallVectorImpl< IncludeDirective > &	Includes,
		const SmallVectorImpl< unsigned > &	Indices,
		unsigned	Cursor
	)

static

Definition at line 1843 of file Format.cpp.

References End, Text, and UINT_MAX.

Referenced by sortCppIncludes().

◆ findJavaImportGroup()

static unsigned clang::format::findJavaImportGroup	(	const FormatStyle &	Style,
		StringRef	ImportIdentifier
	)

static

Definition at line 2053 of file Format.cpp.

References UINT_MAX.

Referenced by sortJavaImports().

◆ fixNamespaceEndComments()

tooling::Replacements clang::format::fixNamespaceEndComments	(	const FormatStyle &	Style,
		StringRef	Code,
		ArrayRef< tooling::Range >	Ranges,
		StringRef	FileName = `"<stdin>"`
	)

Fix namespace end comments in the given Ranges in Code.

Returns the Replacements that fix the namespace comments in all Ranges in Code.

Definition at line 2473 of file Format.cpp.

References clang::format::TokenAnalyzer::process().

◆ formatReplacements()

llvm::Expected< tooling::Replacements > clang::format::formatReplacements	(	StringRef	Code,
		const tooling::Replacements &	Replaces,
		const FormatStyle &	Style
	)

Returns the replacements corresponding to applying and formatting Replaces on success; otheriwse, return an llvm::Error carrying llvm::StringError.

Definition at line 2250 of file Format.cpp.

References clang::tooling::Replacements::add(), clang::tooling::Replacements::empty(), clang::tooling::Replacement::getLength(), clang::tooling::Replacement::getOffset(), clang::tooling::Replacement::getReplacementText(), processReplacements(), clang::format::internal::reformat(), clang::tooling::HeaderIncludes::remove(), sortIncludes(), Style, toString(), and UINT_MAX.

Referenced by clang::tooling::formatAndApplyAllReplacements().

◆ getCanonicalRawStringDelimiter()

static StringRef clang::format::getCanonicalRawStringDelimiter	(	const FormatStyle &	Style,
		FormatStyle::LanguageKind	Language
	)

static

Definition at line 174 of file ContinuationIndenter.cpp.

◆ getChromiumStyle()

FormatStyle clang::format::getChromiumStyle ( FormatStyle::LanguageKind Language )

Returns a format style complying with Chromium's style guide: http://www.chromium.org/developers/coding-style.

Definition at line 962 of file Format.cpp.

References getGoogleStyle().

◆ getCommentSplit()

static BreakableToken::Split clang::format::getCommentSplit	(	StringRef	Text,
		unsigned	ContentStartColumn,
		unsigned	ColumnLimit,
		unsigned	TabWidth,
		encoding::Encoding	Encoding,
		const FormatStyle &	Style,
		bool	DecorationEndsWithStar = `false`
	)

static

Definition at line 66 of file BreakableToken.cpp.

References clang::format::encoding::columnWidthWithTabs(), Encoding, and clang::format::encoding::getCodePointNumBytes().

Referenced by clang::format::BreakableComment::getSplit(), and clang::format::BreakableBlockComment::getSplit().

◆ getContentIndent()

virtual unsigned clang::format::getContentIndent ( unsigned LineIndex ) const

virtual

Returns additional content indent required for the second line after the content at line LineIndex is broken.

Parameters

loooooooooooooong line continuation

Definition at line 149 of file BreakableToken.h.

References getSplit(), and insertBreak().

◆ getContentStartColumn()

virtual unsigned clang::format::getContentStartColumn	(	unsigned	LineIndex,
		bool	Break
	)		const

pure virtual

Returns the column at which content in line LineIndex starts, assuming no reflow.

If Break is true, returns the column at which the line should start after the line break. If Break is false, returns the column at which the line itself will start.

Referenced by clang::format::BreakableStringLiteral::compressWhitespace(), and getRemainingLength().

◆ getEnclosingFunctionName()

static StringRef clang::format::getEnclosingFunctionName ( const FormatToken & Current )

static

Definition at line 1722 of file ContinuationIndenter.cpp.

◆ getFormattingLangOpts()

LangOptions clang::format::getFormattingLangOpts ( const FormatStyle & Style = getLLVMStyle() )

Returns the LangOpts that the formatter expects you to set.

Parameters

Style determines specific settings for lexing mode.

Definition at line 2491 of file Format.cpp.

Referenced by clang::format::FormatTokenLexer::FormatTokenLexer().

◆ getGNUStyle()

FormatStyle clang::format::getGNUStyle ( )

Returns a format style complying with GNU Coding Standards: http://www.gnu.org/prep/standards/standards.html.

Definition at line 1071 of file Format.cpp.

References getLLVMStyle(), and Style.

◆ getGoogleStyle()

FormatStyle clang::format::getGoogleStyle ( FormatStyle::LanguageKind Language )

Returns a format style complying with one of Google's style guides: http://google-styleguide.googlecode.com/svn/trunk/cppguide.xml.

http://google-styleguide.googlecode.com/svn/trunk/javascriptguide.xml. https://developers.google.com/protocol-buffers/docs/style.

Definition at line 835 of file Format.cpp.

References clang::format::FormatStyle::AccessModifierOffset, clang::format::FormatStyle::AlignAfterOpenBracket, clang::format::FormatStyle::AlignEscapedNewlines, clang::format::FormatStyle::AlignOperands, clang::format::FormatStyle::AlignTrailingComments, and getLLVMStyle().

Referenced by getChromiumStyle().

◆ getLanguageByFileName()

static FormatStyle::LanguageKind clang::format::getLanguageByFileName ( StringRef FileName )

static

Definition at line 2526 of file Format.cpp.

Referenced by guessLanguage().

◆ getLanguageName()

StringRef clang::format::getLanguageName ( FormatStyle::LanguageKind Language )

inline

Definition at line 2366 of file Format.h.

Referenced by clang::format::TokenAnalyzer::TokenAnalyzer().

◆ getLastLineEndColumn()

static unsigned clang::format::getLastLineEndColumn	(	StringRef	Text,
		unsigned	StartColumn,
		unsigned	TabWidth,
		encoding::Encoding	Encoding
	)

static

Definition at line 1488 of file ContinuationIndenter.cpp.

References clang::format::encoding::columnWidthWithTabs().

◆ getLengthAfterCompression()

unsigned clang::format::BreakableToken::getLengthAfterCompression	(	unsigned	RemainingTokenColumns,
		Split	Split
	)		const

Returns the number of columns needed to format RemainingTokenColumns, assuming that Split is within the range measured by RemainingTokenColumns, and that the whitespace in Split is reduced to a single space.

Definition at line 195 of file BreakableToken.cpp.

◆ getLengthToMatchingParen()

static unsigned clang::format::getLengthToMatchingParen	(	const FormatToken &	Tok,
		const std::vector< ParenState > &	Stack
	)

static

Definition at line 37 of file ContinuationIndenter.cpp.

◆ getLengthToNextOperator()

static unsigned clang::format::getLengthToNextOperator ( const FormatToken & Tok )

static

Definition at line 107 of file ContinuationIndenter.cpp.

References clang::format::FormatToken::NextOperator, and clang::format::FormatToken::TotalLength.

◆ getLineCommentIndentPrefix()

static StringRef clang::format::getLineCommentIndentPrefix	(	StringRef	Comment,
		const FormatStyle &	Style
	)

static

Definition at line 42 of file BreakableToken.cpp.

Referenced by clang::format::BreakableLineCommentSection::BreakableLineCommentSection().

◆ getLineCount()

virtual unsigned clang::format::getLineCount ( ) const

pure virtual

Returns the number of lines in this token in the original code.

Referenced by clang::format::BreakableStringLiteral::compressWhitespace(), replaceWhitespaceAfterLastLine(), clang::format::BreakableComment::supportsReflow(), and ~BreakableToken().

◆ getLLVMStyle()

FormatStyle clang::format::getLLVMStyle ( FormatStyle::LanguageKind Language = FormatStyle::LanguageKind::LK_Cpp )

Returns a format style complying with the LLVM coding standards: http://llvm.org/docs/CodingStandards.html.

Definition at line 717 of file Format.cpp.

Referenced by getGNUStyle(), getGoogleStyle(), getMicrosoftStyle(), getMozillaStyle(), getNoStyle(), getStyle(), getWebKitStyle(), guessLanguage(), and clang::format::RawStringFormatStyleManager::RawStringFormatStyleManager().

◆ getMicrosoftStyle()

FormatStyle clang::format::getMicrosoftStyle ( FormatStyle::LanguageKind Language )

Returns a format style complying with Microsoft style guide: https://docs.microsoft.com/en-us/visualstudio/ide/editorconfig-code-style-settings-reference?view=vs-2017.

Definition at line 1086 of file Format.cpp.

References getLLVMStyle(), and Style.

◆ getMozillaStyle()

FormatStyle clang::format::getMozillaStyle ( )

Returns a format style complying with Mozilla's style guide: https://developer.mozilla.org/en-US/docs/Developer_Guide/Coding_Style.

Definition at line 1022 of file Format.cpp.

References getLLVMStyle().

◆ getNamespaceToken()

const FormatToken * clang::format::getNamespaceToken	(	const AnnotatedLine *	Line,
		const SmallVectorImpl< AnnotatedLine *> &	AnnotatedLines
	)

Definition at line 155 of file NamespaceEndCommentsFixer.cpp.

◆ getNamespaceTokenText()

StringRef clang::format::getNamespaceTokenText	(	const AnnotatedLine *	Line,
		const SmallVectorImpl< AnnotatedLine *> &	AnnotatedLines
	)

Definition at line 174 of file NamespaceEndCommentsFixer.cpp.

◆ getNoStyle()

FormatStyle clang::format::getNoStyle ( )

Returns style indicating formatting should be not applied at all.

Definition at line 1113 of file Format.cpp.

References getLLVMStyle().

Referenced by getStyle().

◆ getParseCategory()

const std::error_category & clang::format::getParseCategory ( )

Definition at line 613 of file Format.cpp.

Referenced by make_error_code().

◆ getPredefinedStyle()

bool clang::format::getPredefinedStyle	(	StringRef	Name,
		FormatStyle::LanguageKind	Language,
		FormatStyle *	Style
	)

Gets a predefined style for the specified language by name.

Currently supported names: LLVM, Google, Chromium, Mozilla. Names are compared case-insensitively.

Returns true if the Style has been set.

Definition at line 1121 of file Format.cpp.

Referenced by getStyle(), llvm::yaml::MappingTraits< FormatStyle >::mapping(), and clang::format::RawStringFormatStyleManager::RawStringFormatStyleManager().

◆ getRangeLength()

virtual unsigned clang::format::getRangeLength	(	unsigned	LineIndex,
		unsigned	Offset,
		StringRef::size_type	Length,
		unsigned	StartColumn
	)		const

pure virtual

Returns the number of columns required to format the text in the byte range [Offset, Offset + Length).

Offset is the byte offset from the start of the content of the line at LineIndex.

StartColumn is the column at which the text starts in the formatted file, needed to compute tab stops correctly.

Referenced by clang::format::BreakableStringLiteral::compressWhitespace(), getRemainingLength(), and ~BreakableToken().

◆ getRawStringDelimiter()

static llvm::Optional<StringRef> clang::format::getRawStringDelimiter ( StringRef TokenText )

static

Definition at line 149 of file ContinuationIndenter.cpp.

Referenced by getEnclosingFunctionName().

◆ getReflowSplit()

virtual Split clang::format::getReflowSplit	(	unsigned	LineIndex,
		llvm::Regex &	CommentPragmasRegex
	)		const

virtual

Returns a whitespace range (offset, length) of the content at LineIndex such that the content of that line is reflown to the end of the previous one.

Returning (StringRef::npos, 0) indicates reflowing is not possible.

The range will include any whitespace preceding the specified line's content.

If the split is not contained within one token, for example when reflowing line comments, returns (0, <length>).

Definition at line 192 of file BreakableToken.h.

◆ getRemainingLength()

virtual unsigned clang::format::getRemainingLength	(	unsigned	LineIndex,
		unsigned	Offset,
		unsigned	StartColumn
	)		const

virtual

Returns the number of columns required to format the text following the byte Offset in the line LineIndex, including potentially unbreakable sequences of tokens following after the end of the token.

Offset is the byte offset from the start of the content of the line at LineIndex.

StartColumn is the column at which the text starts in the formatted file, needed to compute tab stops correctly.

For breakable tokens that never use extra space at the end of a line, this is equivalent to getRangeLength with a Length of StringRef::npos.

Definition at line 123 of file BreakableToken.h.

References getContentStartColumn(), and getRangeLength().

Referenced by clang::format::BreakableStringLiteral::compressWhitespace().

◆ getSplit()

virtual Split clang::format::getSplit	(	unsigned	LineIndex,
		unsigned	TailOffset,
		unsigned	ColumnLimit,
		unsigned	ContentStartColumn,
		llvm::Regex &	CommentPragmasRegex
	)		const

pure virtual

Returns a range (offset, length) at which to break the line at LineIndex, if previously broken at TailOffset.

If possible, do not violate ColumnLimit, assuming the text starting at TailOffset in the token is formatted starting at ContentStartColumn in the reformatted file.

Referenced by getContentIndent(), and clang::format::BreakableComment::supportsReflow().

◆ getSplitAfterLastLine()

virtual Split clang::format::getSplitAfterLastLine ( unsigned TailOffset ) const

virtual

Returns a whitespace range (offset, length) of the content at the last line that needs to be reformatted after the last line has been reformatted.

A result having offset == StringRef::npos means that no reformat is necessary.

Definition at line 215 of file BreakableToken.h.

◆ getStringSplit()

static BreakableToken::Split clang::format::getStringSplit	(	StringRef	Text,
		unsigned	UsedColumns,
		unsigned	ColumnLimit,
		unsigned	TabWidth,
		encoding::Encoding	Encoding
	)

static

Definition at line 138 of file BreakableToken.cpp.

References clang::format::encoding::columnWidthWithTabs(), Encoding, clang::format::encoding::getCodePointNumBytes(), clang::format::encoding::getEscapeSequenceLength(), clang::isAlphanumeric(), and IsBlank().

Referenced by clang::format::BreakableStringLiteral::getSplit().

◆ getStyle()

llvm::Expected< FormatStyle > clang::format::getStyle	(	StringRef	StyleName,
		StringRef	FileName,
		StringRef	FallbackStyle,
		StringRef	Code = `""`,
		llvm::vfs::FileSystem *	FS = `nullptr`
	)

Construct a FormatStyle based on StyleName.

StyleName can take several forms:

"{<key>: <value>, ...}" - Set specic style parameters.
"<style name>" - One of the style names supported by getPredefinedStyle().
"file" - Load style configuration from a file called .clang-format located in one of the parent directories of FileName or the current directory if FileName is empty.

Parameters

[in]	StyleName	Style name to interpret according to the description above.
[in]	FileName	Path to start search for .clang-format if `StyleName` == "file".
[in]	FallbackStyle	The name of a predefined style used to fallback to in case `StyleName` is "file" and no file can be found.
[in]	Code	The actual code to be formatted. Used to determine the language if the filename isn't sufficient.
[in]	FS	The underlying file system, in which the file resides. By default, the file system is the real file system.

Returns: FormatStyle as specified by StyleName. If StyleName is "file" and no file is found, returns FallbackStyle. If no style could be determined, returns an Error.

Definition at line 2571 of file Format.cpp.

References getLLVMStyle(), getNoStyle(), getPredefinedStyle(), guessLanguage(), make_string_error(), parseConfiguration(), and Style.

Referenced by clang::tooling::formatAndApplyAllReplacements().

◆ getTokenTypeName()

const char * clang::format::getTokenTypeName ( TokenType Type )

Determines the name of a token type.

Definition at line 24 of file FormatToken.cpp.

References LIST_TOKEN_TYPES, NUM_TOKEN_TYPES, and TokNames.

◆ getWebKitStyle()

FormatStyle clang::format::getWebKitStyle ( )

Returns a format style complying with Webkit's style guide: http://www.webkit.org/coding/coding-style.html.

Definition at line 1048 of file Format.cpp.

References clang::format::FormatStyle::AccessModifierOffset, clang::format::FormatStyle::AlignAfterOpenBracket, clang::format::FormatStyle::AlignOperands, clang::format::FormatStyle::AlignTrailingComments, getLLVMStyle(), and Style.

◆ guessLanguage()

FormatStyle::LanguageKind clang::format::guessLanguage	(	StringRef	FileName,
		StringRef	Code
	)

Definition at line 2549 of file Format.cpp.

References getLanguageByFileName(), and getLLVMStyle().

Referenced by getStyle().

◆ hash_combine()

template<class T >

static void clang::format::hash_combine	(	std::size_t &	seed,
		const T &	v
	)

inlinestatic

Definition at line 519 of file UnwrappedLineParser.cpp.

References BK_Block, clang::format::FormatToken::BlockKind, clang::Token::is(), clang::format::FormatToken::is(), clang::format::FormatToken::isOneOf(), clang::format::UnwrappedLine::kInvalidIndex, and clang::format::FormatToken::Tok.

Referenced by clang::serialization::reader::HeaderFileInfoTrait::ComputeHash(), CreateSLocExpansionAbbrev(), clang::HeaderSearch::getCachedModuleFileName(), clang::ast_type_traits::DynTypedNode::DenseMapInfo::getHashValue(), llvm::DenseMapInfo< clang::Sema::FunctionDeclAndLoc >::getHashValue(), clang::CompilerInvocation::getModuleHash(), clang::hash_value(), and clang::TestModuleFileExtension::hashExtension().

◆ insertBreak()

virtual void clang::format::insertBreak	(	unsigned	LineIndex,
		unsigned	TailOffset,
		Split	Split,
		unsigned	ContentIndent,
		WhitespaceManager &	Whitespaces
	)		const

pure virtual

Emits the previously retrieved Split via Whitespaces.

Referenced by getContentIndent(), and replaceWhitespaceAfterLastLine().

◆ introducesBreakBeforeToken()

virtual bool clang::format::introducesBreakBeforeToken ( ) const

virtual

Returns whether there will be a line break at the start of the token.

Definition at line 203 of file BreakableToken.h.

◆ isAllmanBrace()

static bool clang::format::isAllmanBrace ( const FormatToken & Tok )

static

Definition at line 2988 of file TokenAnnotator.cpp.

References BK_Block, clang::format::FormatToken::BlockKind, clang::format::AnnotatedLine::First, clang::format::FormatToken::is(), clang::format::FormatToken::isOneOf(), clang::format::AnnotatedLine::Level, clang::format::FormatToken::NewlinesBefore, clang::format::FormatToken::Previous, and Style.

◆ IsBlank()

static bool clang::format::IsBlank ( char C )

static

Definition at line 29 of file BreakableToken.cpp.

Referenced by getStringSplit().

◆ isFunctionDeclarationName()

static bool clang::format::isFunctionDeclarationName	(	const FormatToken &	Current,
		const AnnotatedLine &	Line
	)

static

Definition at line 2080 of file TokenAnnotator.cpp.

◆ isGoogScope()

static bool clang::format::isGoogScope ( const UnwrappedLine & Line )

static

Definition at line 594 of file UnwrappedLineParser.cpp.

References clang::format::UnwrappedLine::Tokens.

◆ isIIFE()

static bool clang::format::isIIFE	(	const UnwrappedLine &	Line,
		const AdditionalKeywords &	Keywords
	)

static

Definition at line 612 of file UnwrappedLineParser.cpp.

References clang::format::AdditionalKeywords::kw_function, and clang::format::UnwrappedLine::Tokens.

◆ isJSDeclOrStmt()

static bool clang::format::isJSDeclOrStmt	(	const AdditionalKeywords &	Keywords,
		const FormatToken *	FormatTok
	)

static

Definition at line 907 of file UnwrappedLineParser.cpp.

References clang::format::FormatToken::isOneOf(), clang::format::AdditionalKeywords::kw_async, clang::format::AdditionalKeywords::kw_finally, clang::format::AdditionalKeywords::kw_function, clang::format::AdditionalKeywords::kw_import, clang::format::AdditionalKeywords::kw_let, clang::format::AdditionalKeywords::kw_var, clang::format::AdditionalKeywords::kw_yield, and Previous.

◆ isLikelyXml()

bool clang::format::isLikelyXml ( StringRef Code )

Definition at line 2208 of file Format.cpp.

Referenced by sortIncludes().

◆ isMpegTS()

bool clang::format::isMpegTS ( StringRef Code )

Definition at line 2201 of file Format.cpp.

Referenced by sortIncludes().

◆ make_error_code()

std::error_code clang::format::make_error_code ( ParseError e )

Definition at line 617 of file Format.cpp.

References getParseCategory().

Referenced by parseConfiguration().

◆ make_string_error()

llvm::Error clang::format::make_string_error ( const llvm::Twine & Message )

inline

Definition at line 621 of file Format.cpp.

Referenced by clang::tooling::applyAtomicChanges(), getStyle(), and llvm::yaml::MappingTraits< clang::tooling::AtomicChange >::mapping().

◆ maxNestingDepth()

static unsigned clang::format::maxNestingDepth ( const AnnotatedLine & Line )

static

Definition at line 2038 of file TokenAnnotator.cpp.

References clang::format::AnnotatedLine::First, max(), clang::format::FormatToken::NestingLevel, clang::format::FormatToken::Next, and Tok.

◆ mayReflowContent()

static bool clang::format::mayReflowContent ( StringRef Content )

static

Definition at line 303 of file BreakableToken.cpp.

References clang::isPunctuation().

Referenced by clang::format::BreakableBlockComment::mayReflow(), and clang::format::BreakableLineCommentSection::mayReflow().

◆ mustBeJSIdent()

static bool clang::format::mustBeJSIdent	(	const AdditionalKeywords &	Keywords,
		const FormatToken *	FormatTok
	)

static

Definition at line 883 of file UnwrappedLineParser.cpp.

Referenced by mustBeJSIdentOrValue().

◆ mustBeJSIdentOrValue()

static bool clang::format::mustBeJSIdentOrValue	(	const AdditionalKeywords &	Keywords,
		const FormatToken *	FormatTok
	)

static

Definition at line 898 of file UnwrappedLineParser.cpp.

References clang::Token::isLiteral(), clang::format::FormatToken::isOneOf(), mustBeJSIdent(), and clang::format::FormatToken::Tok.

◆ opensProtoMessageField()

static bool clang::format::opensProtoMessageField	(	const FormatToken &	LessTok,
		const FormatStyle &	Style
	)

static

Definition at line 136 of file ContinuationIndenter.cpp.

References clang::format::FormatToken::is(), clang::format::FormatToken::isNot(), clang::format::FormatToken::NestingLevel, and clang::format::FormatToken::Previous.

◆ operator<()

bool clang::format::operator<	(	const JsModuleReference &	LHS,
		const JsModuleReference &	RHS
	)

Definition at line 93 of file SortJavaScriptImports.cpp.

References clang::format::JsModuleReference::Category, clang::format::JsModuleReference::IsExport, clang::format::JsModuleReference::Prefix, and clang::format::JsModuleReference::URL.

◆ parseConfiguration()

std::error_code clang::format::parseConfiguration	(	StringRef	Text,
		FormatStyle *	Style
	)

Parse configuration from YAML-formatted text.

Style->Language is used to get the base style, if the BasedOnStyle option is present.

The FormatStyleSet of Style is reset.

When BasedOnStyle is not present, options not present in the YAML document, are retained in Style.

Definition at line 1147 of file Format.cpp.

References make_error_code().

Referenced by getStyle(), and llvm::yaml::MappingTraits< TaintConfig::NameArgsPair >::mapping().

◆ printDebugInfo()

static LLVM_ATTRIBUTE_UNUSED void clang::format::printDebugInfo	(	const UnwrappedLine &	Line,
		StringRef	Prefix = `""`
	)

static

Definition at line 2445 of file UnwrappedLineParser.cpp.

References clang::format::UnwrappedLineNode::Children, clang::comments::tok::eof, clang::format::UnwrappedLine::FirstStartColumn, clang::format::FormatToken::HasUnescapedNewline, clang::format::UnwrappedLine::InPPDirective, clang::Token::is(), clang::format::UnwrappedLine::kInvalidIndex, clang::format::UnwrappedLine::Level, clang::format::FormatToken::NewlinesBefore, Node, clang::format::FormatToken::Previous, clang::format::FormatToken::Tok, and clang::format::UnwrappedLine::Tokens.

◆ processReplacements()

template<typename T >

static llvm::Expected<tooling::Replacements> clang::format::processReplacements	(	T	ProcessFunc,
		StringRef	Code,
		const tooling::Replacements &	Replaces,
		const FormatStyle &	Style
	)

static

Definition at line 2231 of file Format.cpp.

References clang::tooling::applyAllReplacements(), clang::tooling::Replacements::begin(), clang::tooling::Replacements::empty(), clang::tooling::Replacements::getAffectedRanges(), and clang::tooling::Replacements::merge().

Referenced by cleanupAroundReplacements(), and formatReplacements().

◆ reflow()

virtual void clang::format::reflow	(	unsigned	LineIndex,
		WhitespaceManager &	Whitespaces
	)		const

virtual

Reflows the current line into the end of the previous one.

Definition at line 198 of file BreakableToken.h.

◆ reformat() [1/2]

tooling::Replacements clang::format::reformat	(	const FormatStyle &	Style,
		StringRef	Code,
		ArrayRef< tooling::Range >	Ranges,
		StringRef	FileName = `"<stdin>"`,
		FormattingAttemptStatus *	Status = `nullptr`
	)

Reformats the given Ranges in Code.

Each range is extended on either end to its next bigger logic unit, i.e. everything that might influence its formatting or might be influenced by its formatting.

Returns the Replacements necessary to make all Ranges comply with Style.

If Status is non-null, its value will be populated with the status of this formatting attempt. See FormattingAttemptStatus.

Definition at line 2443 of file Format.cpp.

Referenced by clang::tooling::applyAtomicChanges().

◆ reformat() [2/2]

tooling::Replacements clang::format::reformat	(	const FormatStyle &	Style,
		StringRef	Code,
		ArrayRef< tooling::Range >	Ranges,
		StringRef	FileName,
		bool *	IncompleteFormat
	)

Same as above, except if IncompleteFormat is non-null, its value will be set to true if any of the affected ranges were not formatted due to a non-recoverable syntax error.

Definition at line 2463 of file Format.cpp.

◆ replaceCRLF()

std::string clang::format::replaceCRLF ( const std::string & Code )

Definition at line 1864 of file Format.cpp.

◆ replaceWhitespaceAfterLastLine()

void clang::format::replaceWhitespaceAfterLastLine	(	unsigned	TailOffset,
		Split	SplitAfterLastLine,
		WhitespaceManager &	Whitespaces
	)		const

Replaces the whitespace from SplitAfterLastLine on the last line after the last line has been formatted by performing a reformatting.

Definition at line 221 of file BreakableToken.h.

References getLineCount(), and insertBreak().

◆ ShouldBreakBeforeBrace()

static bool clang::format::ShouldBreakBeforeBrace	(	const FormatStyle &	Style,
		const FormatToken &	InitialToken
	)

static

Definition at line 630 of file UnwrappedLineParser.cpp.

References clang::if(), clang::format::FormatToken::is(), and clang::format::FormatToken::isOneOf().

◆ shouldIndentWrappedSelectorName()

static bool clang::format::shouldIndentWrappedSelectorName	(	const FormatStyle &	Style,
		LineType	LineType
	)

static

Definition at line 30 of file ContinuationIndenter.cpp.

References LT_ObjCMethodDecl.

◆ sortCppIncludes() [1/2]

static void clang::format::sortCppIncludes	(	const FormatStyle &	Style,
		const SmallVectorImpl< IncludeDirective > &	Includes,
		ArrayRef< tooling::Range >	Ranges,
		StringRef	FileName,
		StringRef	Code,
		tooling::Replacements &	Replaces,
		unsigned *	Cursor
	)

static

Definition at line 1892 of file Format.cpp.

References affectsRange(), Filename, FindCursorIndex(), and Priority.

◆ sortCppIncludes() [2/2]

tooling::Replacements clang::format::sortCppIncludes	(	const FormatStyle &	Style,
		StringRef	Code,
		ArrayRef< tooling::Range >	Ranges,
		StringRef	FileName,
		tooling::Replacements &	Replaces,
		unsigned *	Cursor
	)

Definition at line 1979 of file Format.cpp.

Referenced by sortIncludes().

◆ sortIncludes()

tooling::Replacements clang::format::sortIncludes	(	const FormatStyle &	Style,
		StringRef	Code,
		ArrayRef< tooling::Range >	Ranges,
		StringRef	FileName,
		unsigned *	Cursor = `nullptr`
	)

Returns the replacements necessary to sort all #include blocks that are affected by Ranges.

Definition at line 2210 of file Format.cpp.

References isLikelyXml(), isMpegTS(), sortCppIncludes(), sortJavaImports(), and sortJavaScriptImports().

Referenced by clang::tooling::applyAtomicChanges(), and formatReplacements().

◆ sortJavaImports() [1/2]

static void clang::format::sortJavaImports	(	const FormatStyle &	Style,
		const SmallVectorImpl< JavaImportDirective > &	Imports,
		ArrayRef< tooling::Range >	Ranges,
		StringRef	FileName,
		StringRef	Code,
		tooling::Replacements &	Replaces
	)

static

Definition at line 2073 of file Format.cpp.

References affectsRange(), findJavaImportGroup(), Identifier, and IsStatic.

◆ sortJavaImports() [2/2]

tooling::Replacements clang::format::sortJavaImports	(	const FormatStyle &	Style,
		StringRef	Code,
		ArrayRef< tooling::Range >	Ranges,
		StringRef	FileName,
		tooling::Replacements &	Replaces
	)

Definition at line 2148 of file Format.cpp.

Referenced by sortIncludes().

◆ sortJavaScriptImports()

tooling::Replacements clang::format::sortJavaScriptImports	(	const FormatStyle &	Style,
		StringRef	Code,
		ArrayRef< tooling::Range >	Ranges,
		StringRef	FileName
	)

Definition at line 440 of file SortJavaScriptImports.cpp.

References clang::format::TokenAnalyzer::process().

Referenced by sortIncludes().

◆ sortUsingDeclarations()

tooling::Replacements clang::format::sortUsingDeclarations	(	const FormatStyle &	Style,
		StringRef	Code,
		ArrayRef< tooling::Range >	Ranges,
		StringRef	FileName = `"<stdin>"`
	)

Sort consecutive using declarations in the given Ranges in Code.

Returns the Replacements that sort the using declarations in all Ranges in Code.

Definition at line 2482 of file Format.cpp.

References clang::format::TokenAnalyzer::process().

◆ startsNextParameter()

static bool clang::format::startsNextParameter	(	const FormatToken &	Current,
		const FormatStyle &	Style
	)

static

Definition at line 120 of file ContinuationIndenter.cpp.

◆ startsSegmentOfBuilderTypeCall()

static bool clang::format::startsSegmentOfBuilderTypeCall ( const FormatToken & Tok )

static

Definition at line 115 of file ContinuationIndenter.cpp.

References clang::format::FormatToken::closesScope(), clang::format::FormatToken::isMemberAccess(), and clang::format::FormatToken::Previous.

◆ supportsReflow()

virtual bool clang::format::supportsReflow ( ) const

virtual

Returns whether the token supports reflowing text.

Definition at line 179 of file BreakableToken.h.

◆ switchesFormatting()

*p Token must be a comment *bool clang::format::switchesFormatting ( const FormatToken & Token )

Checks if Token switches formatting, like /* clang-format off.

Definition at line 186 of file BreakableToken.cpp.

References clang::format::FormatToken::is(), and clang::format::FormatToken::TokenText.

Referenced by getEnclosingFunctionName(), clang::format::BreakableBlockComment::mayReflow(), and clang::format::BreakableLineCommentSection::mayReflow().

◆ tokenCanStartNewLine()

static bool clang::format::tokenCanStartNewLine ( const clang::Token & Tok )

static

Definition at line 857 of file UnwrappedLineParser.cpp.

References clang::Token::isNot().

◆ updateNextToken()

virtual void clang::format::updateNextToken ( LineState & State ) const

virtual

Updates the next token of State to the next token after this one.

This can be used when this token manages a set of underlying tokens as a unit and is responsible for the formatting of the them.

Definition at line 231 of file BreakableToken.h.

◆ ~BreakableToken()

virtual clang::format::~BreakableToken ( )

virtual

Definition at line 94 of file BreakableToken.h.

References getLineCount(), getRangeLength(), and Offset.

Variable Documentation

◆ Blanks

const char* const clang::format::Blanks = " \t\v\f\r"

static

Definition at line 28 of file BreakableToken.cpp.

◆ DefaultFallbackStyle

const char * clang::format::DefaultFallbackStyle = "LLVM"

The suggested predefined style to use as the fallback style in getStyle.

Different builds can modify the value to the preferred styles.

Definition at line 2569 of file Format.cpp.

◆ DefaultFormatStyle

const char * clang::format::DefaultFormatStyle = "file"

The suggested format style to use by default.

This allows tools using getStyle to have a consistent default style. Different builds can modify the value to the preferred styles.

Definition at line 2567 of file Format.cpp.

◆ Encoding

const encoding::Encoding clang::format::Encoding

protected

Definition at line 241 of file BreakableToken.h.

Referenced by getCommentSplit(), clang::format::BreakableBlockComment::getRangeLength(), clang::format::BreakableLineCommentSection::getRangeLength(), clang::format::BreakableStringLiteral::getRemainingLength(), clang::format::BreakableStringLiteral::getSplit(), clang::format::BreakableComment::getSplit(), clang::format::BreakableBlockComment::getSplit(), and getStringSplit().

◆ InPPDirective

const bool clang::format::InPPDirective

protected

Definition at line 240 of file BreakableToken.h.

Referenced by clang::format::BreakableBlockComment::getSplit(), and clang::format::WhitespaceManager::useCRLF().

◆ itself

to be on a line of clang::format::itself

Base class for tokens / ranges of tokens that can allow breaking within the tokens - for example, to avoid whitespace beyond the column limit, or to reflow text.

Generally, a breakable token consists of logical lines, addressed by a line index. For example, in a sequence of line comments, each line comment is its own logical line; similarly, for a block comment, each line in the block comment is on its own logical line.

There are two methods to compute the layout of the token:

getRangeLength measures the number of columns needed for a range of text within a logical line, and
getContentStartColumn returns the start column at which we want the content of a logical line to start (potentially after introducing a line break).

The mechanism to adapt the layout of the breakable token is organised around the concept of a Split, which is a whitespace range that signifies a position of the content of a token where a reformatting might be done.

Operating with splits is divided into two operations:

getSplit, for finding a split starting at a position,
insertBreak, for executing the split using a whitespace manager.

There is a pair of operations that are used to compress a long whitespace range with a single space if that will bring the line length under the column limit:

getLineLengthAfterCompression, for calculating the size in columns of the line after a whitespace range has been compressed, and
compressWhitespace, for executing the whitespace compression using a whitespace manager; note that the compressed whitespace may be in the middle of the original line and of the reformatted line.

For tokens where the whitespace before each line needs to be also reformatted, for example for tokens supporting reflow, there are analogous operations that might be executed before the main line breaking occurs:

getReflowSplit, for finding a split such that the content preceding it needs to be specially reflown,
reflow, for executing the split using a whitespace manager,
introducesBreakBefore, for checking if reformatting the beginning of the content introduces a line break before it,
adaptStartOfLine, for executing the reflow using a whitespace manager.

For tokens that require the whitespace after the last line to be reformatted, for example in multiline jsdoc comments that require the trailing '

Definition at line 34 of file BreakableToken.h.

◆ reflown

to be on a line of there are analogous operations* that might be executed after the last line has been for finding a split after the last line that needs* to be clang::format::reflown

Definition at line 34 of file BreakableToken.h.

◆ reformatted

to be on a line of there are analogous operations* that might be executed after the last line has been clang::format::reformatted

Definition at line 34 of file BreakableToken.h.

◆ replaceWhitespaceAfterLastLine

to be on a line of there are analogous operations* that might be executed after the last line has been for finding a split after the last line that needs* to be * clang::format::replaceWhitespaceAfterLastLine

Definition at line 34 of file BreakableToken.h.

◆ Style

const FormatStyle& clang::format::Style

protected

Definition at line 242 of file BreakableToken.h.

Referenced by AlignMacroSequence(), clang::format::TokenAnnotator::annotate(), clang::format::TokenAnnotator::calculateFormattingInformation(), cleanupAroundReplacements(), configurationAsText(), expandPresets(), clang::format::CommaSeparatedList::formatAfterToken(), formatReplacements(), clang::format::BreakableBlockComment::getContentIndent(), getGNUStyle(), getMicrosoftStyle(), clang::format::BreakableBlockComment::getRangeLength(), clang::format::BreakableLineCommentSection::getRangeLength(), clang::format::BreakableStringLiteral::getRemainingLength(), clang::format::BreakableStringLiteral::getSplit(), clang::format::BreakableComment::getSplit(), clang::format::BreakableBlockComment::getSplit(), getStyle(), getWebKitStyle(), clang::format::WhitespaceManager::Change::indentAndNestingLevel(), isAllmanBrace(), llvm::yaml::MappingTraits< clang::tooling::AtomicChange >::mapping(), clang::format::CommaSeparatedList::precomputeFormattingInfos(), clang::format::TokenAnnotator::setCommentLineLevels(), and clang::VarDecl::setInitStyle().

◆ StyleOptionHelpDescription

const char * clang::format::StyleOptionHelpDescription

Initial value:

=
    "Coding style, currently supports:\n"
    "  LLVM, Google, Chromium, Mozilla, WebKit.\n"
    "Use -style=file to load style configuration from\n"
    ".clang-format file located in one of the parent\n"
    "directories of the source file (or current\n"
    "directory for stdin).\n"
    "Use -style=\"{key: value, ...}\" to set specific\n"
    "parameters, e.g.:\n"
    "  -style=\"{BasedOnStyle: llvm, IndentWidth: 8}\""

Description to be used for help text for a llvm::cl option for specifying format style.

The description is closely related to the operation of getStyle().

Definition at line 2515 of file Format.cpp.

◆ Tok

const FormatToken& clang::format::Tok

protected

Definition at line 239 of file BreakableToken.h.

Referenced by clang::Sema::ActOnStringLiteral(), clang::TokenRewriter::AddTokenBefore(), clang::format::AffectedRangeManager::AffectedRangeManager(), clang::format::AffectedRangeManager::affectsCharSourceRange(), AuditedType(), clang::format::BreakableBlockComment::BreakableBlockComment(), clang::format::BreakableLineCommentSection::BreakableLineCommentSection(), clang::Preprocessor::CheckEndOfDirective(), compareModuleHeaders(), DoPrintMacros(), clang::DoPrintPreprocessedInput(), clang::MacroInfo::dump(), clang::PreferredTypeBuilder::enterFunctionArgument(), clang::Preprocessor::EnterMacro(), clang::PreferredTypeBuilder::enterParenExpr(), clang::Preprocessor::EnterToken(), clang::PreferredTypeBuilder::enterTypeCast(), clang::PreferredTypeBuilder::enterVariableInit(), EvaluateDirectiveSubExpr(), EvaluateFeatureLikeBuiltinMacro(), clang::PrintDependencyDirectivesSourceMinimizerAction::ExecuteAction(), clang::DumpTokensAction::ExecuteAction(), clang::PreprocessOnlyAction::ExecuteAction(), findDirectives(), clang::Lexer::findLocationAfterToken(), clang::Lexer::findNextToken(), formatModuleId(), GenerateNewArgTokens(), clang::Lexer::getCurrentBufferOffset(), getEnclosingFunctionName(), clang::format::FormatTokenLexer::getKeywords(), clang::ModuleMapParser::getLocation(), clang::Preprocessor::getPreprocessingRecord(), clang::MacroInfo::getReplacementToken(), clang::StringLiteralParser::getUDSuffixOffset(), clang::Preprocessor::HandlePragmaHdrstop(), clang::Preprocessor::HandlePragmaPoison(), clang::html::HighlightMacros(), clang::TokenLexer::Init(), isConfigurationPattern(), clang::PragmaNamespace::IsEmpty(), isMapModifier(), isMapType(), IsStringPrefix(), isTargetEnvironment(), clang::format::FormatTokenLexer::lex(), clang::TokenLexer::Lex(), clang::Preprocessor::LexOnOffSwitch(), LocPropertyAttribute(), maxNestingDepth(), clang::format::BreakableBlockComment::mayReflow(), clang::format::BreakableLineCommentSection::mayReflow(), outputPrintable(), ParseAlignPragma(), parseDeclareSimdClauses(), ParseLoopHintValue(), clang::Parser::parseMapperModifier(), parseMapType(), clang::Parser::parseMapTypeModifiers(), clang::ModuleMapParser::parseModuleMapFile(), parseOpenMPDirectiveKind(), clang::Parser::ParseOpenMPParensExpr(), parseOpenMPReductionId(), parseOpenMPSimpleClause(), clang::Parser::ParseOpenMPVarList(), clang::Preprocessor::ParsePragmaPushOrPopMacro(), PrintMacroDefinition(), ReadLineMarkerFlags(), clang::Lexer::ReadToEndOfLine(), clang::ASTReader::ReadToken(), resyncUTF8(), clang::RewriteIncludesInInput(), clang::format::TokenAnnotator::setCommentLineLevels(), shouldAddRequirement(), clang::Preprocessor::SkipTokensWhileUsingPCH(), clang::MacroArgs::StringifyArgument(), clang::html::SyntaxHighlight(), clang::syntax::Leaf::token(), clang::format::BreakableComment::tokenAt(), clang::TokenRewriter::TokenRewriter(), clang::format::WhitespaceManager::useCRLF(), UseNSOptionsMacro(), and clang::TokenLexer::~TokenLexer().

Namespaces

Classes

Enumerations

Functions

Variables

Enumeration Type Documentation

◆ BraceBlockKind

◆ FormatDecision

◆ LexerState

◆ LineType

◆ ParameterPackingKind

◆ ParseError

◆ TokenType

Function Documentation

◆ adaptStartOfLine()

◆ affectsRange()

◆ AlignMacroSequence()

◆ AlignTokens()

◆ AlignTokenSequence()

◆ BreakableToken()

◆ cleanup()

◆ cleanupAroundReplacements()

◆ CodePointsBetween()

◆ compressWhitespace()

◆ configurationAsText()

◆ continuesLineCommentSection()

◆ expandPresets()

◆ FindCursorIndex()

◆ findJavaImportGroup()

◆ fixNamespaceEndComments()

◆ formatReplacements()

◆ getCanonicalRawStringDelimiter()

◆ getChromiumStyle()

◆ getCommentSplit()

◆ getContentIndent()

◆ getContentStartColumn()

◆ getEnclosingFunctionName()

◆ getFormattingLangOpts()

◆ getGNUStyle()

◆ getGoogleStyle()

◆ getLanguageByFileName()

◆ getLanguageName()

◆ getLastLineEndColumn()

◆ getLengthAfterCompression()

◆ getLengthToMatchingParen()

◆ getLengthToNextOperator()

◆ getLineCommentIndentPrefix()

◆ getLineCount()

◆ getLLVMStyle()

◆ getMicrosoftStyle()

◆ getMozillaStyle()

◆ getNamespaceToken()

◆ getNamespaceTokenText()

◆ getNoStyle()

◆ getParseCategory()

◆ getPredefinedStyle()

◆ getRangeLength()

◆ getRawStringDelimiter()

◆ getReflowSplit()

◆ getRemainingLength()

◆ getSplit()

◆ getSplitAfterLastLine()

◆ getStringSplit()

◆ getStyle()

◆ getTokenTypeName()

◆ getWebKitStyle()

◆ guessLanguage()

◆ hash_combine()

◆ insertBreak()

◆ introducesBreakBeforeToken()

◆ isAllmanBrace()

◆ IsBlank()

◆ isFunctionDeclarationName()

◆ isGoogScope()

◆ isIIFE()

◆ isJSDeclOrStmt()

◆ isLikelyXml()

◆ isMpegTS()

◆ make_error_code()

◆ make_string_error()