clang 19.0.0git
Public Types | Public Member Functions | Public Attributes | List of all members
clang::CodeCompletionResult Class Reference

Captures a result of code completion. More...

#include "clang/Sema/CodeCompleteConsumer.h"

Public Types

enum  ResultKind { RK_Declaration = 0 , RK_Keyword , RK_Macro , RK_Pattern }
 Describes the kind of result generated. More...
 

Public Member Functions

 CodeCompletionResult (const NamedDecl *Declaration, unsigned Priority, NestedNameSpecifier *Qualifier=nullptr, bool QualifierIsInformative=false, bool Accessible=true, std::vector< FixItHint > FixIts=std::vector< FixItHint >())
 Build a result that refers to a declaration.
 
 CodeCompletionResult (const char *Keyword, unsigned Priority=CCP_Keyword)
 Build a result that refers to a keyword or symbol.
 
 CodeCompletionResult (const IdentifierInfo *Macro, const MacroInfo *MI=nullptr, unsigned Priority=CCP_Macro)
 Build a result that refers to a macro.
 
 CodeCompletionResult (CodeCompletionString *Pattern, unsigned Priority=CCP_CodePattern, CXCursorKind CursorKind=CXCursor_NotImplemented, CXAvailabilityKind Availability=CXAvailability_Available, const NamedDecl *D=nullptr)
 Build a result that refers to a pattern.
 
 CodeCompletionResult (CodeCompletionString *Pattern, const NamedDecl *D, unsigned Priority)
 Build a result that refers to a pattern with an associated declaration.
 
const NamedDeclgetDeclaration () const
 Retrieve the declaration stored in this result.
 
const char * getKeyword () const
 Retrieve the keyword stored in this result.
 
CodeCompletionStringCreateCodeCompletionString (Sema &S, const CodeCompletionContext &CCContext, CodeCompletionAllocator &Allocator, CodeCompletionTUInfo &CCTUInfo, bool IncludeBriefComments)
 Create a new code-completion string that describes how to insert this result into a program.
 
CodeCompletionStringCreateCodeCompletionString (ASTContext &Ctx, Preprocessor &PP, const CodeCompletionContext &CCContext, CodeCompletionAllocator &Allocator, CodeCompletionTUInfo &CCTUInfo, bool IncludeBriefComments)
 If possible, create a new code completion string for the given result.
 
CodeCompletionStringCreateCodeCompletionStringForMacro (Preprocessor &PP, CodeCompletionAllocator &Allocator, CodeCompletionTUInfo &CCTUInfo)
 Creates a new code-completion string for the macro result.
 
CodeCompletionStringcreateCodeCompletionStringForDecl (Preprocessor &PP, ASTContext &Ctx, CodeCompletionBuilder &Result, bool IncludeBriefComments, const CodeCompletionContext &CCContext, PrintingPolicy &Policy)
 
CodeCompletionStringcreateCodeCompletionStringForOverride (Preprocessor &PP, ASTContext &Ctx, CodeCompletionBuilder &Result, bool IncludeBriefComments, const CodeCompletionContext &CCContext, PrintingPolicy &Policy)
 
StringRef getOrderedName (std::string &Saved) const
 Retrieve the name that should be used to order a result.
 

Public Attributes

const NamedDeclDeclaration = nullptr
 When Kind == RK_Declaration or RK_Pattern, the declaration we are referring to.
 
union {
   const char *   Keyword
 When Kind == RK_Keyword, the string representing the keyword or symbol's spelling. More...
 
   CodeCompletionString *   Pattern
 When Kind == RK_Pattern, the code-completion string that describes the completion text to insert. More...
 
   const IdentifierInfo *   Macro
 When Kind == RK_Macro, the identifier that refers to a macro. More...
 
}; 
 
unsigned Priority
 The priority of this particular code-completion result.
 
unsigned StartParameter = 0
 Specifies which parameter (of a function, Objective-C method, macro, etc.) we should start with when formatting the result.
 
ResultKind Kind
 The kind of result stored here.
 
CXCursorKind CursorKind
 The cursor kind that describes this result.
 
CXAvailabilityKind Availability = CXAvailability_Available
 The availability of this result.
 
std::vector< FixItHintFixIts
 Fix-its that must be applied before inserting the text for the corresponding completion.
 
bool Hidden: 1
 Whether this result is hidden by another name.
 
bool InBaseClass: 1
 Whether this is a class member from base class.
 
bool QualifierIsInformative: 1
 Whether this result was found via lookup into a base class.
 
bool StartsNestedNameSpecifier: 1
 Whether this declaration is the beginning of a nested-name-specifier and, therefore, should be followed by '::'.
 
bool AllParametersAreInformative: 1
 Whether all parameters (of a function, Objective-C method, etc.) should be considered "informative".
 
bool DeclaringEntity: 1
 Whether we're completing a declaration of the given entity, rather than a use of that entity.
 
bool FunctionCanBeCall: 1
 When completing a function, whether it can be a call.
 
NestedNameSpecifierQualifier = nullptr
 If the result should have a nested-name-specifier, this is it.
 
const UsingShadowDeclShadowDecl = nullptr
 If this Decl was unshadowed by using declaration, this can store a pointer to the UsingShadowDecl which was used in the unshadowing process.
 
const MacroInfoMacroDefInfo = nullptr
 If the result is RK_Macro, this can store the information about the macro definition.
 

Detailed Description

Captures a result of code completion.

Definition at line 760 of file CodeCompleteConsumer.h.

Member Enumeration Documentation

◆ ResultKind

Describes the kind of result generated.

Enumerator
RK_Declaration 

Refers to a declaration.

RK_Keyword 

Refers to a keyword or symbol.

RK_Macro 

Refers to a macro.

RK_Pattern 

Refers to a precomputed pattern.

Definition at line 763 of file CodeCompleteConsumer.h.

Constructor & Destructor Documentation

◆ CodeCompletionResult() [1/5]

clang::CodeCompletionResult::CodeCompletionResult ( const NamedDecl Declaration,
unsigned  Priority,
NestedNameSpecifier Qualifier = nullptr,
bool  QualifierIsInformative = false,
bool  Accessible = true,
std::vector< FixItHint FixIts = std::vector<FixItHint>() 
)
inline

Build a result that refers to a declaration.

Definition at line 884 of file CodeCompleteConsumer.h.

◆ CodeCompletionResult() [2/5]

clang::CodeCompletionResult::CodeCompletionResult ( const char *  Keyword,
unsigned  Priority = CCP_Keyword 
)
inline

Build a result that refers to a keyword or symbol.

Definition at line 899 of file CodeCompleteConsumer.h.

◆ CodeCompletionResult() [3/5]

clang::CodeCompletionResult::CodeCompletionResult ( const IdentifierInfo Macro,
const MacroInfo MI = nullptr,
unsigned  Priority = CCP_Macro 
)
inline

Build a result that refers to a macro.

Definition at line 907 of file CodeCompleteConsumer.h.

◆ CodeCompletionResult() [4/5]

clang::CodeCompletionResult::CodeCompletionResult ( CodeCompletionString Pattern,
unsigned  Priority = CCP_CodePattern,
CXCursorKind  CursorKind = CXCursor_NotImplemented,
CXAvailabilityKind  Availability = CXAvailability_Available,
const NamedDecl D = nullptr 
)
inline

Build a result that refers to a pattern.

Definition at line 917 of file CodeCompleteConsumer.h.

◆ CodeCompletionResult() [5/5]

clang::CodeCompletionResult::CodeCompletionResult ( CodeCompletionString Pattern,
const NamedDecl D,
unsigned  Priority 
)
inline

Build a result that refers to a pattern with an associated declaration.

Definition at line 930 of file CodeCompleteConsumer.h.

Member Function Documentation

◆ CreateCodeCompletionString() [1/2]

CodeCompletionString * CodeCompletionResult::CreateCodeCompletionString ( ASTContext Ctx,
Preprocessor PP,
const CodeCompletionContext CCContext,
CodeCompletionAllocator Allocator,
CodeCompletionTUInfo CCTUInfo,
bool  IncludeBriefComments 
)

If possible, create a new code completion string for the given result.

Returns
Either a new, heap-allocated code completion string describing how to use this result, or NULL to indicate that the string or name of the result is all that is needed.

Definition at line 3448 of file SemaCodeComplete.cpp.

References Availability, createCodeCompletionStringForDecl(), CreateCodeCompletionStringForMacro(), Declaration, getCompletionPrintingPolicy(), clang::Decl::getDeclContext(), clang::getPatternCompletionComment(), Keyword, Kind, Pattern, Priority, clang::Result, RK_Declaration, RK_Keyword, RK_Macro, and RK_Pattern.

◆ CreateCodeCompletionString() [2/2]

CodeCompletionString * CodeCompletionResult::CreateCodeCompletionString ( Sema S,
const CodeCompletionContext CCContext,
CodeCompletionAllocator Allocator,
CodeCompletionTUInfo CCTUInfo,
bool  IncludeBriefComments 
)

Create a new code-completion string that describes how to insert this result into a program.

Parameters
SThe semantic analysis that created the result.
AllocatorThe allocator that will be used to allocate the string itself.

Definition at line 3388 of file SemaCodeComplete.cpp.

References clang::Sema::Context, CreateCodeCompletionString(), and clang::Sema::PP.

Referenced by CreateCodeCompletionString().

◆ createCodeCompletionStringForDecl()

CodeCompletionString * CodeCompletionResult::createCodeCompletionStringForDecl ( Preprocessor PP,
ASTContext Ctx,
CodeCompletionBuilder Result,
bool  IncludeBriefComments,
const CodeCompletionContext CCContext,
PrintingPolicy Policy 
)

Definition at line 3535 of file SemaCodeComplete.cpp.

References AddFunctionParameterChunks(), AddFunctionTypeQualsToCompletionString(), AddQualifierToCompletionString(), AddResultTypeChunk(), AddTemplateParameterChunks(), AddTypedNameChunk(), AllParametersAreInformative, clang::CodeCompletionString::CK_HorizontalSpace, clang::CodeCompletionString::CK_LeftAngle, clang::CodeCompletionString::CK_LeftParen, clang::CodeCompletionString::CK_RightAngle, clang::CodeCompletionString::CK_RightParen, Declaration, DeclaringEntity, extractFunctorCallOperator(), FormatFunctionParameter(), formatObjCParamQualifiers(), clang::Function, FunctionCanBeCall, clang::QualType::getAsString(), clang::CodeCompletionContext::getBaseType(), clang::getCompletionComment(), clang::Decl::getDeclContext(), clang::Selector::getIdentifierInfoForSlot(), clang::NamedDecl::getNameAsString(), clang::Selector::getNameForSlot(), clang::Selector::getNumArgs(), clang::Type::getObjCSubstitutions(), clang::Type::isBlockPointerType(), clang::QualType::isNull(), clang::Selector::isUnarySelector(), clang::FunctionDecl::isVariadic(), Keyword, clang::Sema::MarkDeducedTemplateParameters(), MaybeAddSentinel(), P, clang::FunctionDecl::param_begin(), clang::FunctionDecl::param_end(), clang::FunctionDecl::param_size(), clang::Parameter, Qualifier, QualifierIsInformative, clang::Result, clang::Decl::specific_attrs(), StartParameter, StartsNestedNameSpecifier, and clang::QualType::substObjCTypeArgs().

Referenced by CreateCodeCompletionString(), and createCodeCompletionStringForOverride().

◆ CreateCodeCompletionStringForMacro()

CodeCompletionString * CodeCompletionResult::CreateCodeCompletionStringForMacro ( Preprocessor PP,
CodeCompletionAllocator Allocator,
CodeCompletionTUInfo CCTUInfo 
)

◆ createCodeCompletionStringForOverride()

CodeCompletionString * CodeCompletionResult::createCodeCompletionStringForOverride ( Preprocessor PP,
ASTContext Ctx,
CodeCompletionBuilder Result,
bool  IncludeBriefComments,
const CodeCompletionContext CCContext,
PrintingPolicy Policy 
)

◆ getDeclaration()

const NamedDecl * clang::CodeCompletionResult::getDeclaration ( ) const
inline

Retrieve the declaration stored in this result.

This might be nullptr if Kind is RK_Pattern.

Definition at line 941 of file CodeCompleteConsumer.h.

References Declaration, Kind, RK_Declaration, and RK_Pattern.

◆ getKeyword()

const char * clang::CodeCompletionResult::getKeyword ( ) const
inline

Retrieve the keyword stored in this result.

Definition at line 948 of file CodeCompleteConsumer.h.

References Keyword, Kind, and RK_Keyword.

◆ getOrderedName()

StringRef CodeCompletionResult::getOrderedName ( std::string &  Saved) const

Retrieve the name that should be used to order a result.

If the name needs to be constructed as a string, that string will be saved into Saved and the returned StringRef will refer to it.

Definition at line 837 of file CodeCompleteConsumer.cpp.

References clang::Declaration, and Id.

Referenced by clang::operator<().

Member Data Documentation

◆ 

union { ... } clang::CodeCompletionResult::@212

◆ AllParametersAreInformative

bool clang::CodeCompletionResult::AllParametersAreInformative

Whether all parameters (of a function, Objective-C method, etc.) should be considered "informative".

Definition at line 855 of file CodeCompleteConsumer.h.

Referenced by createCodeCompletionStringForDecl().

◆ Availability

CXAvailabilityKind clang::CodeCompletionResult::Availability = CXAvailability_Available

The availability of this result.

Definition at line 808 of file CodeCompleteConsumer.h.

Referenced by CreateCodeCompletionString(), and CreateCodeCompletionStringForMacro().

◆ CursorKind

CXCursorKind clang::CodeCompletionResult::CursorKind

The cursor kind that describes this result.

Definition at line 805 of file CodeCompleteConsumer.h.

◆ Declaration

const NamedDecl* clang::CodeCompletionResult::Declaration = nullptr

When Kind == RK_Declaration or RK_Pattern, the declaration we are referring to.

In the latter case, the declaration might be NULL.

Definition at line 779 of file CodeCompleteConsumer.h.

Referenced by CreateCodeCompletionString(), createCodeCompletionStringForDecl(), and getDeclaration().

◆ DeclaringEntity

bool clang::CodeCompletionResult::DeclaringEntity

Whether we're completing a declaration of the given entity, rather than a use of that entity.

Definition at line 859 of file CodeCompleteConsumer.h.

Referenced by createCodeCompletionStringForDecl().

◆ FixIts

std::vector<FixItHint> clang::CodeCompletionResult::FixIts

Fix-its that must be applied before inserting the text for the corresponding completion.

By default, CodeCompletionBuilder only returns completions with empty fix-its. Extra completions with non-empty fix-its should be explicitly requested by setting CompletionOptions::IncludeFixIts.

For the clients to be able to compute position of the cursor after applying fix-its, the following conditions are guaranteed to hold for RemoveRange of the stored fix-its:

  • Ranges in the fix-its are guaranteed to never contain the completion point (or identifier under completion point, if any) inside them, except at the start or at the end of the range.
  • If a fix-it range starts or ends with completion point (or starts or ends after the identifier under completion point), it will contain at least one character. It allows to unambiguously recompute completion point after applying the fix-it.

The intuition is that provided fix-its change code around the identifier we complete, but are not allowed to touch the identifier itself or the completion point. One example of completions with corrections are the ones replacing '.' with '->' and vice versa:

std::unique_ptr<std::vector<int>> vec_ptr; In 'vec_ptr.^', one of the completions is 'push_back', it requires replacing '.' with '->'. In 'vec_ptr->^', one of the completions is 'release', it requires replacing '->' with '.'.

Definition at line 838 of file CodeCompleteConsumer.h.

◆ FunctionCanBeCall

bool clang::CodeCompletionResult::FunctionCanBeCall

When completing a function, whether it can be a call.

This will usually be true, but we have some heuristics, e.g. when a pointer to a non-static member function is completed outside of that class' scope, it can never be a call.

Definition at line 865 of file CodeCompleteConsumer.h.

Referenced by createCodeCompletionStringForDecl().

◆ Hidden

bool clang::CodeCompletionResult::Hidden

Whether this result is hidden by another name.

Definition at line 841 of file CodeCompleteConsumer.h.

◆ InBaseClass

bool clang::CodeCompletionResult::InBaseClass

Whether this is a class member from base class.

Definition at line 844 of file CodeCompleteConsumer.h.

Referenced by setInBaseClass().

◆ Keyword

const char* clang::CodeCompletionResult::Keyword

When Kind == RK_Keyword, the string representing the keyword or symbol's spelling.

Definition at line 784 of file CodeCompleteConsumer.h.

Referenced by CreateCodeCompletionString(), createCodeCompletionStringForDecl(), and getKeyword().

◆ Kind

ResultKind clang::CodeCompletionResult::Kind

The kind of result stored here.

Definition at line 802 of file CodeCompleteConsumer.h.

Referenced by CreateCodeCompletionString(), CreateCodeCompletionStringForMacro(), getDeclaration(), and getKeyword().

◆ Macro

const IdentifierInfo* clang::CodeCompletionResult::Macro

When Kind == RK_Macro, the identifier that refers to a macro.

Definition at line 791 of file CodeCompleteConsumer.h.

Referenced by CreateCodeCompletionStringForMacro().

◆ MacroDefInfo

const MacroInfo* clang::CodeCompletionResult::MacroDefInfo = nullptr

If the result is RK_Macro, this can store the information about the macro definition.

This should be set in most cases but can be missing when the macro has been undefined.

Definition at line 881 of file CodeCompleteConsumer.h.

◆ Pattern

CodeCompletionString* clang::CodeCompletionResult::Pattern

When Kind == RK_Pattern, the code-completion string that describes the completion text to insert.

Definition at line 788 of file CodeCompleteConsumer.h.

Referenced by CreateCodeCompletionString().

◆ Priority

unsigned clang::CodeCompletionResult::Priority

The priority of this particular code-completion result.

Definition at line 795 of file CodeCompleteConsumer.h.

Referenced by CreateCodeCompletionString(), CreateCodeCompletionStringForMacro(), and setInBaseClass().

◆ Qualifier

NestedNameSpecifier* clang::CodeCompletionResult::Qualifier = nullptr

If the result should have a nested-name-specifier, this is it.

When QualifierIsInformative, the nested-name-specifier is informative rather than required.

Definition at line 870 of file CodeCompleteConsumer.h.

Referenced by createCodeCompletionStringForDecl().

◆ QualifierIsInformative

bool clang::CodeCompletionResult::QualifierIsInformative

Whether this result was found via lookup into a base class.

Definition at line 847 of file CodeCompleteConsumer.h.

Referenced by createCodeCompletionStringForDecl().

◆ ShadowDecl

const UsingShadowDecl* clang::CodeCompletionResult::ShadowDecl = nullptr

If this Decl was unshadowed by using declaration, this can store a pointer to the UsingShadowDecl which was used in the unshadowing process.

This information can be used to uprank CodeCompletionResults / which have corresponding using decl::qualified::name; nearby.

Definition at line 876 of file CodeCompleteConsumer.h.

◆ StartParameter

unsigned clang::CodeCompletionResult::StartParameter = 0

Specifies which parameter (of a function, Objective-C method, macro, etc.) we should start with when formatting the result.

Definition at line 799 of file CodeCompleteConsumer.h.

Referenced by createCodeCompletionStringForDecl().

◆ StartsNestedNameSpecifier

bool clang::CodeCompletionResult::StartsNestedNameSpecifier

Whether this declaration is the beginning of a nested-name-specifier and, therefore, should be followed by '::'.

Definition at line 851 of file CodeCompleteConsumer.h.

Referenced by createCodeCompletionStringForDecl().


The documentation for this class was generated from the following files: