clang-tools 20.0.0git
Classes | Public Types | Public Attributes | List of all members
clang::clangd::Symbol Struct Reference

The class presents a C++ symbol, e.g. More...

#include <Symbol.h>

Classes

struct  IncludeHeaderWithReferences
 

Public Types

enum  IncludeDirective : uint8_t { Invalid = 0 , Include = 1 , Import = 2 }
 
enum  SymbolFlag : uint8_t {
  None = 0 , IndexedForCodeCompletion = 1 << 0 , Deprecated = 1 << 1 , ImplementationDetail = 1 << 2 ,
  VisibleOutsideFile = 1 << 3
}
 

Public Attributes

SymbolID ID
 The ID of the symbol.
 
index::SymbolInfo SymInfo = index::SymbolInfo()
 The symbol information, like symbol kind.
 
llvm::StringRef Name
 The unqualified name of the symbol, e.g. "bar" (for ns::bar).
 
llvm::StringRef Scope
 The containing namespace. e.g. "" (global), "ns::" (top-level namespace).
 
SymbolLocation Definition
 The location of the symbol's definition, if one was found.
 
SymbolLocation CanonicalDeclaration
 The location of the preferred declaration of the symbol.
 
unsigned References = 0
 The number of translation units that reference this symbol from their main file.
 
SymbolOrigin Origin = SymbolOrigin::Unknown
 Where this symbol came from. Usually an index provides a constant value.
 
llvm::StringRef Signature
 A brief description of the symbol that can be appended in the completion candidate list.
 
llvm::StringRef TemplateSpecializationArgs
 Argument list in human-readable format, will be displayed to help disambiguate between different specializations of a template.
 
llvm::StringRef CompletionSnippetSuffix
 What to insert when completing this symbol, after the symbol name.
 
llvm::StringRef Documentation
 Documentation including comment for the symbol declaration.
 
llvm::StringRef ReturnType
 Type when this symbol is used in an expression.
 
llvm::StringRef Type
 Raw representation of the OpaqueType of the symbol, used for scoring purposes.
 
llvm::SmallVector< IncludeHeaderWithReferences, 1 > IncludeHeaders
 One Symbol can potentially be included via different headers.
 
SymbolFlag Flags = SymbolFlag::None
 

Detailed Description

The class presents a C++ symbol, e.g.

class, function.

WARNING: Symbols do not own much of their underlying data - typically strings are owned by a SymbolSlab. They should be treated as non-owning references. Copies are shallow.

When adding new unowned data fields to Symbol, remember to update:

A fully documented symbol can be split as: size_type std::map<k, t>::count(const K& key) const | Return | Scope |Name| Signature | We split up these components to allow display flexibility later.

Definition at line 39 of file Symbol.h.

Member Enumeration Documentation

◆ IncludeDirective

Enumerator
Invalid 
Include 

#include "header.h"

Import 

#import "header.h"

Definition at line 90 of file Symbol.h.

◆ SymbolFlag

Enumerator
None 
IndexedForCodeCompletion 

Whether or not this symbol is meant to be used for the code completion.

See also isIndexedForCodeCompletion(). Note that we don't store completion information (signature, snippet, type, includes) if the symbol is not indexed for code completion.

Deprecated 

Indicates if the symbol is deprecated.

ImplementationDetail 

Symbol is an implementation detail.

VisibleOutsideFile 

Symbol is visible to other files (not e.g. a static helper function).

Definition at line 135 of file Symbol.h.

Member Data Documentation

◆ CanonicalDeclaration

SymbolLocation clang::clangd::Symbol::CanonicalDeclaration

The location of the preferred declaration of the symbol.

This just covers the symbol name. This may be the same as Definition.

A C++ symbol may have multiple declarations, and we pick one to prefer.

  • For classes, the canonical declaration should be the definition.
  • For non-inline functions, the canonical declaration typically appears in the ".h" file corresponding to the definition.

Definition at line 59 of file Symbol.h.

Referenced by clang::clangd::getCorrespondingHeaderOrSource(), clang::clangd::locateSymbolTextually(), llvm::yaml::MappingTraits< Symbol >::mapping(), clang::clangd::mergeSymbol(), clang::clangd::symbolToLocation(), and clang::clangd::remote::Marshaller::toProtobuf().

◆ CompletionSnippetSuffix

llvm::StringRef clang::clangd::Symbol::CompletionSnippetSuffix

What to insert when completing this symbol, after the symbol name.

This is in LSP snippet syntax (e.g. "({$0})" for a no-args function). (When snippets are disabled, the symbol name alone is used). Only set when the symbol is indexed for completion.

Definition at line 77 of file Symbol.h.

Referenced by llvm::yaml::MappingTraits< Symbol >::mapping(), clang::clangd::mergeSymbol(), and clang::clangd::remote::Marshaller::toProtobuf().

◆ Definition

SymbolLocation clang::clangd::Symbol::Definition

The location of the symbol's definition, if one was found.

This just covers the symbol name (e.g. without class/function body).

Definition at line 50 of file Symbol.h.

Referenced by clang::clangd::getCorrespondingHeaderOrSource(), clang::clangd::locateSymbolTextually(), llvm::yaml::MappingTraits< Symbol >::mapping(), clang::clangd::mergeSymbol(), clang::clangd::symbolToLocation(), and clang::clangd::remote::Marshaller::toProtobuf().

◆ Documentation

llvm::StringRef clang::clangd::Symbol::Documentation

Documentation including comment for the symbol declaration.

Definition at line 79 of file Symbol.h.

Referenced by llvm::yaml::MappingTraits< Symbol >::mapping(), clang::clangd::mergeSymbol(), and clang::clangd::remote::Marshaller::toProtobuf().

◆ Flags

SymbolFlag clang::clangd::Symbol::Flags = SymbolFlag::None

◆ ID

SymbolID clang::clangd::Symbol::ID

◆ IncludeHeaders

llvm::SmallVector<IncludeHeaderWithReferences, 1> clang::clangd::Symbol::IncludeHeaders

One Symbol can potentially be included via different headers.

  • If we haven't seen a definition, this covers all declarations.
  • If we have seen a definition, this covers declarations visible from any definition. Only set when the symbol is indexed for completion.

Definition at line 133 of file Symbol.h.

Referenced by clang::clangd::getRankedIncludes(), llvm::yaml::MappingTraits< Symbol >::mapping(), clang::clangd::mergeSymbol(), and clang::clangd::remote::Marshaller::toProtobuf().

◆ Name

llvm::StringRef clang::clangd::Symbol::Name

◆ Origin

SymbolOrigin clang::clangd::Symbol::Origin = SymbolOrigin::Unknown

Where this symbol came from. Usually an index provides a constant value.

Definition at line 64 of file Symbol.h.

Referenced by clang::clangd::mergeSymbol(), clang::clangd::objcSym(), and clang::clangd::sym().

◆ References

unsigned clang::clangd::Symbol::References = 0

The number of translation units that reference this symbol from their main file.

This number is only meaningful if aggregated in an index.

Definition at line 62 of file Symbol.h.

Referenced by llvm::yaml::MappingTraits< Symbol >::mapping(), clang::clangd::mergeSymbol(), and clang::clangd::remote::Marshaller::toProtobuf().

◆ ReturnType

llvm::StringRef clang::clangd::Symbol::ReturnType

Type when this symbol is used in an expression.

(Short display form). e.g. return type of a function, or type of a variable. Only set when the symbol is indexed for completion.

Definition at line 83 of file Symbol.h.

Referenced by llvm::yaml::MappingTraits< Symbol >::mapping(), clang::clangd::mergeSymbol(), and clang::clangd::remote::Marshaller::toProtobuf().

◆ Scope

llvm::StringRef clang::clangd::Symbol::Scope

◆ Signature

llvm::StringRef clang::clangd::Symbol::Signature

A brief description of the symbol that can be appended in the completion candidate list.

For example, "(X x, Y y) const" is a function signature. Only set when the symbol is indexed for completion.

Definition at line 68 of file Symbol.h.

Referenced by llvm::yaml::MappingTraits< Symbol >::mapping(), clang::clangd::mergeSymbol(), clang::clangd::sym(), and clang::clangd::remote::Marshaller::toProtobuf().

◆ SymInfo

index::SymbolInfo clang::clangd::Symbol::SymInfo = index::SymbolInfo()

◆ TemplateSpecializationArgs

llvm::StringRef clang::clangd::Symbol::TemplateSpecializationArgs

Argument list in human-readable format, will be displayed to help disambiguate between different specializations of a template.

Empty for non-specializations. Example: "<int, bool, 3>"

Definition at line 72 of file Symbol.h.

Referenced by clang::clangd::getQualifiedName(), clang::clangd::getWorkspaceSymbols(), clang::clangd::locateSymbolTextually(), llvm::yaml::MappingTraits< Symbol >::mapping(), and clang::clangd::remote::Marshaller::toProtobuf().

◆ Type

llvm::StringRef clang::clangd::Symbol::Type

Raw representation of the OpaqueType of the symbol, used for scoring purposes.

Only set when the symbol is indexed for completion.

Definition at line 88 of file Symbol.h.

Referenced by llvm::yaml::MappingTraits< Symbol >::mapping(), llvm::yaml::MappingTraits< SymbolAndSignals >::mapping(), clang::clangd::mergeSymbol(), and clang::clangd::remote::Marshaller::toProtobuf().


The documentation for this struct was generated from the following file: