Functions
std::pair< Token, SourceLocation >	getPreviousTokenAndStart (SourceLocation Location, const SourceManager &SM, const LangOptions &LangOpts, bool SkipComments)

Token	getPreviousToken (SourceLocation Location, const SourceManager &SM, const LangOptions &LangOpts, bool SkipComments=true)
	Returns previous token or `tok::unknown` if not found.

SourceLocation	findPreviousTokenStart (SourceLocation Start, const SourceManager &SM, const LangOptions &LangOpts)

SourceLocation	findPreviousTokenKind (SourceLocation Start, const SourceManager &SM, const LangOptions &LangOpts, tok::TokenKind TK)

SourceLocation	findNextTerminator (SourceLocation Start, const SourceManager &SM, const LangOptions &LangOpts)

std::optional< Token >	findNextTokenIncludingComments (SourceLocation Start, const SourceManager &SM, const LangOptions &LangOpts)

std::optional< Token >	findNextTokenSkippingComments (SourceLocation Start, const SourceManager &SM, const LangOptions &LangOpts)

bool	rangeContainsExpansionsOrDirectives (SourceRange Range, const SourceManager &SM, const LangOptions &LangOpts)
	Re-lex the provide `Range` and return `false` if either a macro spans multiple tokens, a pre-processor directive or failure to retrieve the next token is found, otherwise `true`.

std::optional< Token >	getQualifyingToken (tok::TokenKind TK, CharSourceRange Range, const ASTContext &Context, const SourceManager &SM)
	Assuming that `Range` spans a CVR-qualified type, returns the token in `Range` that is responsible for the qualification.

static bool	breakAndReturnEnd (const Stmt &S)

static bool	breakAndReturnEndPlus1Token (const Stmt &S)

static SourceLocation	getSemicolonAfterStmtEndLoc (const SourceLocation &EndLoc, const SourceManager &SM, const LangOptions &LangOpts)

SourceLocation	getUnifiedEndLoc (const Stmt &S, const SourceManager &SM, const LangOptions &LangOpts)
	Stmt->getEndLoc does not always behave the same way depending on Token type.

SourceLocation	getLocationForNoexceptSpecifier (const FunctionDecl *FuncDecl, const SourceManager &SM)
	For a given FunctionDecl returns the location where you would need to place the noexcept specifier.

template<typename TokenKind , typename... TokenKinds>
SourceLocation	findPreviousAnyTokenKind (SourceLocation Start, const SourceManager &SM, const LangOptions &LangOpts, TokenKind TK, TokenKinds... TKs)

template<typename TokenKind , typename... TokenKinds>
SourceLocation	findNextAnyTokenKind (SourceLocation Start, const SourceManager &SM, const LangOptions &LangOpts, TokenKind TK, TokenKinds... TKs)

Function Documentation

◆ breakAndReturnEnd()

static bool clang::tidy::utils::lexer::breakAndReturnEnd ( const Stmt & S )

static

Definition at line 190 of file LexerUtils.cpp.

Referenced by getUnifiedEndLoc().

◆ breakAndReturnEndPlus1Token()

static bool clang::tidy::utils::lexer::breakAndReturnEndPlus1Token ( const Stmt & S )

static

Definition at line 194 of file LexerUtils.cpp.

Referenced by getUnifiedEndLoc().

◆ findNextAnyTokenKind()

template<typename TokenKind , typename... TokenKinds>

SourceLocation clang::tidy::utils::lexer::findNextAnyTokenKind	(	SourceLocation	Start,
		const SourceManager &	SM,
		const LangOptions &	LangOpts,
		TokenKind	TK,
		TokenKinds...	TKs
	)

Definition at line 68 of file LexerUtils.h.

Referenced by clang::tidy::modernize::findInsertionForConstraint(), and findNextTerminator().

◆ findNextTerminator()

SourceLocation clang::tidy::utils::lexer::findNextTerminator	(	SourceLocation	Start,
		const SourceManager &	SM,
		const LangOptions &	LangOpts
	)

Definition at line 84 of file LexerUtils.cpp.

References findNextAnyTokenKind().

Referenced by clang::tidy::cppcoreguidelines::changePrivateDestructorVisibilityTo(), clang::tidy::cppcoreguidelines::InitVariablesCheck::check(), clang::tidy::performance::TriviallyDestructibleCheck::check(), clang::tidy::readability::AvoidReturnWithVoidValueCheck::check(), and clang::tidy::readability::declRanges().

◆ findNextTokenIncludingComments()

std::optional< Token > clang::tidy::utils::lexer::findNextTokenIncludingComments	(	SourceLocation	Start,
		const SourceManager &	SM,
		const LangOptions &	LangOpts
	)

Definition at line 90 of file LexerUtils.cpp.

Referenced by clang::tidy::modernize::UseOverrideCheck::check(), and clang::tidy::modernize::NS::getNamespaceBackRange().

◆ findNextTokenSkippingComments()

std::optional< Token > clang::tidy::utils::lexer::findNextTokenSkippingComments	(	SourceLocation	Start,
		const SourceManager &	SM,
		const LangOptions &	LangOpts
	)

Definition at line 113 of file LexerUtils.cpp.

Referenced by clang::tidy::llvm_libc::InlineFunctionDeclCheck::check(), clang::tidy::modernize::UseEqualsDefaultCheck::check(), clang::tidy::readability::cleanInitialValue(), clang::tidy::modernize::generateReplacements(), clang::tidy::modernize::NS::getCleanedNamespaceFrontRange(), clang::tidy::readability::getNamespaceNameAsWritten(), and getSemicolonAfterStmtEndLoc().

◆ findPreviousAnyTokenKind()

template<typename TokenKind , typename... TokenKinds>

SourceLocation clang::tidy::utils::lexer::findPreviousAnyTokenKind	(	SourceLocation	Start,
		const SourceManager &	SM,
		const LangOptions &	LangOpts,
		TokenKind	TK,
		TokenKinds...	TKs
	)

Definition at line 44 of file LexerUtils.h.

References findPreviousTokenStart().

Referenced by clang::tidy::utils::fixit::changeReferencee(), and clang::tidy::readability::findStartOfIndirection().

◆ findPreviousTokenKind()

SourceLocation clang::tidy::utils::lexer::findPreviousTokenKind	(	SourceLocation	Start,
		const SourceManager &	SM,
		const LangOptions &	LangOpts,
		tok::TokenKind	TK
	)

Definition at line 61 of file LexerUtils.cpp.

References findPreviousTokenStart().

Referenced by clang::tidy::utils::fixit::changePointer(), clang::tidy::readability::declRanges(), clang::tidy::cppcoreguidelines::findDefaultCaptureEnd(), clang::tidy::modernize::findInsertionForConstraint(), clang::tidy::modernize::getConditionRange(), clang::tidy::modernize::getTypeRange(), and clang::tidy::modernize::handleTrailingTemplateType().

◆ findPreviousTokenStart()

SourceLocation clang::tidy::utils::lexer::findPreviousTokenStart	(	SourceLocation	Start,
		const SourceManager &	SM,
		const LangOptions &	LangOpts
	)

Definition at line 48 of file LexerUtils.cpp.

Referenced by clang::tidy::readability::declRanges(), findPreviousAnyTokenKind(), findPreviousTokenKind(), and clang::tidy::utils::fixit::skipLParensBackwards().

◆ getLocationForNoexceptSpecifier()

SourceLocation clang::tidy::utils::lexer::getLocationForNoexceptSpecifier	(	const FunctionDecl *	FuncDecl,
		const SourceManager &	SM
	)

For a given FunctionDecl returns the location where you would need to place the noexcept specifier.

Definition at line 254 of file LexerUtils.cpp.

References FuncDecl.

Referenced by clang::tidy::performance::NoexceptFunctionBaseCheck::check().

◆ getPreviousToken()

Token clang::tidy::utils::lexer::getPreviousToken	(	SourceLocation	Location,
		const SourceManager &	SM,
		const LangOptions &	LangOpts,
		bool	SkipComments
	)

Returns previous token or tok::unknown if not found.

Definition at line 41 of file LexerUtils.cpp.

References getPreviousTokenAndStart().

Referenced by clang::tidy::utils::fixit::changeVarDeclToReference(), clang::tidy::bugprone::OptionalValueConversionCheck::check(), clang::tidy::bugprone::SuspiciousSemicolonCheck::check(), clang::tidy::readability::DeleteNullPointerCheck::check(), clang::tidy::readability::declRanges(), clang::tidy::bugprone::getCommentsBeforeLoc(), clang::tidy::readability::getFullInitRangeInclWhitespaces(), and clang::tidy::utils::fixit::skipLParensBackwards().

◆ getPreviousTokenAndStart()

std::pair< Token, SourceLocation > clang::tidy::utils::lexer::getPreviousTokenAndStart	(	SourceLocation	Location,
		const SourceManager &	SM,
		const LangOptions &	LangOpts,
		bool	SkipComments
	)

Definition at line 18 of file LexerUtils.cpp.

Referenced by clang::tidy::modernize::getConditionText(), getPreviousToken(), and clang::tidy::readability::isAtStartOfLineIncludingEmptyMacro().

◆ getQualifyingToken()

std::optional< Token > clang::tidy::utils::lexer::getQualifyingToken	(	tok::TokenKind	TK,
		CharSourceRange	Range,
		const ASTContext &	Context,
		const SourceManager &	SM
	)

Assuming that Range spans a CVR-qualified type, returns the token in Range that is responsible for the qualification.

Range must be valid with respect to SM. Returns std::nullopt if no qualifying tokens are found.

Note: : doesn't support member function qualifiers.

Definition at line 151 of file LexerUtils.cpp.

References Info, and Range.

Referenced by clang::tidy::readability::findConstToRemove().

◆ getSemicolonAfterStmtEndLoc()

static SourceLocation clang::tidy::utils::lexer::getSemicolonAfterStmtEndLoc	(	const SourceLocation &	EndLoc,
		const SourceManager &	SM,
		const LangOptions &	LangOpts
	)

static

Definition at line 201 of file LexerUtils.cpp.

References findNextTokenSkippingComments().

Referenced by getUnifiedEndLoc().

◆ getUnifiedEndLoc()

SourceLocation clang::tidy::utils::lexer::getUnifiedEndLoc	(	const Stmt &	S,
		const SourceManager &	SM,
		const LangOptions &	LangOpts
	)

Stmt->getEndLoc does not always behave the same way depending on Token type.

See implementation for exceptions.

Definition at line 238 of file LexerUtils.cpp.

References breakAndReturnEnd(), breakAndReturnEndPlus1Token(), and getSemicolonAfterStmtEndLoc().

Referenced by clang::tidy::modernize::UseEqualsDefaultCheck::check(), and clang::tidy::utils::findEndLocation().

◆ rangeContainsExpansionsOrDirectives()

bool clang::tidy::utils::lexer::rangeContainsExpansionsOrDirectives	(	SourceRange	Range,
		const SourceManager &	SM,
		const LangOptions &	LangOpts
	)

Re-lex the provide Range and return false if either a macro spans multiple tokens, a pre-processor directive or failure to retrieve the next token is found, otherwise true.

Definition at line 127 of file LexerUtils.cpp.

References Loc, and Range.

Referenced by clang::tidy::modernize::UseEqualsDefaultCheck::check(), and clang::tidy::readability::declRanges().

Functions

Function Documentation

◆ breakAndReturnEnd()

◆ breakAndReturnEndPlus1Token()

◆ findNextAnyTokenKind()

◆ findNextTerminator()

◆ findNextTokenIncludingComments()

◆ findNextTokenSkippingComments()

◆ findPreviousAnyTokenKind()

◆ findPreviousTokenKind()

◆ findPreviousTokenStart()

◆ getLocationForNoexceptSpecifier()

◆ getPreviousToken()

◆ getPreviousTokenAndStart()

◆ getQualifyingToken()

◆ getSemicolonAfterStmtEndLoc()

◆ getUnifiedEndLoc()

◆ rangeContainsExpansionsOrDirectives()