clang
7.0.0
|
One of these records is kept for each identifier that is lexed. More...
#include "clang/Basic/IdentifierTable.h"
Public Member Functions | |
IdentifierInfo () | |
IdentifierInfo (const IdentifierInfo &)=delete | |
IdentifierInfo & | operator= (const IdentifierInfo &)=delete |
template<std::size_t StrLen> | |
bool | isStr (const char(&Str)[StrLen]) const |
Return true if this is the identifier for the specified string. More... | |
bool | isStr (llvm::StringRef Str) const |
Return true if this is the identifier for the specified StringRef. More... | |
const char * | getNameStart () const |
Return the beginning of the actual null-terminated string for this identifier. More... | |
unsigned | getLength () const |
Efficiently return the length of this identifier info. More... | |
StringRef | getName () const |
Return the actual identifier string. More... | |
bool | hasMacroDefinition () const |
Return true if this identifier is #defined to some other value. More... | |
void | setHasMacroDefinition (bool Val) |
bool | hadMacroDefinition () const |
Returns true if this identifier was #defined to some value at any moment. More... | |
tok::TokenKind | getTokenID () const |
If this is a source-language token (e.g. More... | |
bool | hasRevertedTokenIDToIdentifier () const |
True if revertTokenIDToIdentifier() was called. More... | |
void | revertTokenIDToIdentifier () |
Revert TokenID to tok::identifier; used for GNU libstdc++ 4.2 compatibility. More... | |
void | revertIdentifierToTokenID (tok::TokenKind TK) |
tok::PPKeywordKind | getPPKeywordID () const |
Return the preprocessor keyword ID for this identifier. More... | |
tok::ObjCKeywordKind | getObjCKeywordID () const |
Return the Objective-C keyword ID for the this identifier. More... | |
void | setObjCKeywordID (tok::ObjCKeywordKind ID) |
bool | hasRevertedBuiltin () const |
True if setNotBuiltin() was called. More... | |
void | revertBuiltin () |
Revert the identifier to a non-builtin identifier. More... | |
unsigned | getBuiltinID () const |
Return a value indicating whether this is a builtin function. More... | |
void | setBuiltinID (unsigned ID) |
unsigned | getObjCOrBuiltinID () const |
void | setObjCOrBuiltinID (unsigned ID) |
bool | isExtensionToken () const |
get/setExtension - Initialize information about whether or not this language token is an extension. More... | |
void | setIsExtensionToken (bool Val) |
bool | isFutureCompatKeyword () const |
is/setIsFutureCompatKeyword - Initialize information about whether or not this language token is a keyword in a newer or proposed Standard. More... | |
void | setIsFutureCompatKeyword (bool Val) |
void | setIsPoisoned (bool Value=true) |
setIsPoisoned - Mark this identifier as poisoned. More... | |
bool | isPoisoned () const |
Return true if this token has been poisoned. More... | |
void | setIsCPlusPlusOperatorKeyword (bool Val=true) |
isCPlusPlusOperatorKeyword/setIsCPlusPlusOperatorKeyword controls whether this identifier is a C++ alternate representation of an operator. More... | |
bool | isCPlusPlusOperatorKeyword () const |
bool | isKeyword (const LangOptions &LangOpts) const |
Return true if this token is a keyword in the specified language. More... | |
bool | isCPlusPlusKeyword (const LangOptions &LangOpts) const |
Return true if this token is a C++ keyword in the specified language. More... | |
template<typename T > | |
T * | getFETokenInfo () const |
getFETokenInfo/setFETokenInfo - The language front-end is allowed to associate arbitrary metadata with this token. More... | |
void | setFETokenInfo (void *T) |
bool | isHandleIdentifierCase () const |
Return true if the Preprocessor::HandleIdentifier must be called on a token of this identifier. More... | |
bool | isFromAST () const |
Return true if the identifier in its current state was loaded from an AST file. More... | |
void | setIsFromAST () |
bool | hasChangedSinceDeserialization () const |
Determine whether this identifier has changed since it was loaded from an AST file. More... | |
void | setChangedSinceDeserialization () |
Note that this identifier has changed since it was loaded from an AST file. More... | |
bool | hasFETokenInfoChangedSinceDeserialization () const |
Determine whether the frontend token information for this identifier has changed since it was loaded from an AST file. More... | |
void | setFETokenInfoChangedSinceDeserialization () |
Note that the frontend token information for this identifier has changed since it was loaded from an AST file. More... | |
bool | isOutOfDate () const |
Determine whether the information for this identifier is out of date with respect to the external source. More... | |
void | setOutOfDate (bool OOD) |
Set whether the information for this identifier is out of date with respect to the external source. More... | |
bool | isModulesImport () const |
Determine whether this is the contextual keyword import . More... | |
void | setModulesImport (bool I) |
Set whether this identifier is the contextual keyword import . More... | |
bool | isEditorPlaceholder () const |
Return true if this identifier is an editor placeholder. More... | |
bool | operator< (const IdentifierInfo &RHS) const |
Provide less than operator for lexicographical sorting. More... | |
Friends | |
class | IdentifierTable |
One of these records is kept for each identifier that is lexed.
This contains information about whether the token was #define'd, is a language keyword, or if it is a front-end token of some sort (e.g. a variable or function name). The preprocessor keeps this information in a set, and all tok::identifier tokens have a pointer to one of these.
Definition at line 50 of file IdentifierTable.h.
IdentifierInfo::IdentifierInfo | ( | ) |
Definition at line 40 of file IdentifierTable.cpp.
References clang::IdentifierInfoLookup::~IdentifierInfoLookup(), and clang::IdentifierIterator::~IdentifierIterator().
Referenced by clang::IdentifierTable::getOwn().
|
delete |
|
inline |
Return a value indicating whether this is a builtin function.
0 is not-built-in. 1+ are specific builtin functions.
Definition at line 219 of file IdentifierTable.h.
References clang::tok::NUM_OBJC_KEYWORDS.
Referenced by clang::FunctionDecl::getBuiltinID(), clang::ASTImporter::Import(), isTargetEnvironment(), LookupBuiltin(), ParseLoopHintValue(), and clang::serialization::reader::ASTIdentifierLookupTrait::ReadData().
|
inline |
getFETokenInfo/setFETokenInfo - The language front-end is allowed to associate arbitrary metadata with this token.
Definition at line 290 of file IdentifierTable.h.
Referenced by getDeclForLocalLookup(), and isInterestingIdentifier().
|
inline |
Efficiently return the length of this identifier info.
Definition at line 122 of file IdentifierTable.h.
Referenced by getDeclForLocalLookup(), getName(), clang::Sema::isCurrentClassNameTypo(), isReservedName(), and isStr().
|
inline |
Return the actual identifier string.
Definition at line 136 of file IdentifierTable.h.
References getLength(), and getNameStart().
Referenced by clang::Sema::ActOnPragmaVisibility(), clang::Sema::ActOnTemplateIdType(), AddDefinedMacroToHash(), clang::ODRHash::AddIdentifierInfo(), appendEnumType(), appendRecordType(), clang::ento::AnyFunctionCall::argumentsMayEscape(), attributeHasIdentifierArg(), attributeHasVariadicIdentifierArg(), attributeIsTypeArgAttr(), attributeParsedArgsUnevaluated(), CheckArrayDesignatorSyntax(), CheckAvailabilitySpecList(), clang::Sema::checkStringLiteralArgumentAttr(), clang::DeclarationName::compare(), DetectEOL(), DiagnoseNamespaceInlineMismatch(), distributeNullabilityTypeAttr(), findKnownClass(), clang::ento::coreFoundation::followsCreateRule(), FormatFunctionParameter(), clang::index::generateUSRForMacro(), clang::index::CodegenNameGenerator::Implementation::getAllManglings(), clang::Selector::getAsString(), getCalleeName(), clang::ento::CheckerContext::getCalleeName(), getCCTypeAttrKind(), clang::Preprocessor::getCodeCompletionFilter(), getDeclForLocalLookup(), clang::arcmt::getFileRemappings(), getFutureCompatDiagKind(), getIdentifier(), clang::ento::ExprEngine::getInitialState(), clang::Selector::getInstTypeMethodFamily(), clang::MacroExpansion::getName(), clang::Selector::getNameForSlot(), clang::getParameterABISpelling(), handleObjCOwnershipTypeAttr(), clang::PragmaNamespace::HandlePragma(), clang::Preprocessor::HandlePragmaModuleBuild(), clang::Preprocessor::HandlePragmaPopMacro(), clang::ASTImporter::Import(), clang::CallGraph::includeInGraph(), InNamespace(), isAttributeLateParsed(), isBetterMultiversionCandidate(), IsBuiltInOrStandardCXX11Attribute(), isCharSpecialization(), clang::ento::cocoa::isCocoaObjectRef(), isConfigurationPattern(), clang::Sema::isCurrentClassNameTypo(), isEditorPlaceholder(), isImplicitThis(), clang::PrintingCodeCompleteConsumer::isResultFilteredOut(), IsStructurallyEquivalent(), isTargetArch(), isTargetEnvironment(), isTargetOS(), isTargetVendor(), clang::Preprocessor::LexOnOffSwitch(), LookupMethodInReceiverType(), clang::MacroPPCallbacks::MacroUndefined(), clang::MangleContext::mangleGlobalBlock(), clang::MangleContext::mangleName(), clang::Sema::mergeAvailabilityAttr(), clang::analyze_format_string::FormatSpecifier::namedTypeToLengthModifier(), operator<(), ParseAlignPragma(), parseDeclareSimdClauses(), ParseLoopHintValue(), clang::Parser::ParseMSAsmIdentifier(), PragmaLoopHintString(), clang::NestedNameSpecifier::print(), PrintFloatingLiteral(), PrintMacroDefinition(), clang::RewriteMacrosInInput(), rewriteToNSEnumDecl(), rewriteToNSMacroDecl(), shouldWarnOnMacroDef(), shouldWarnOnMacroUndef(), startsWithWord(), TryNamespaceTypoCorrection(), and clang::ASTReader::updateOutOfDateIdentifier().
|
inline |
Return the beginning of the actual null-terminated string for this identifier.
Definition at line 109 of file IdentifierTable.h.
Referenced by clang::Preprocessor::checkModuleIsAvailable(), clang::PTHManager::Create(), diagnoseRedundantPropertyNullability(), clang::Preprocessor::dumpMacroInfo(), getDeclForLocalLookup(), getName(), and isStr().
|
inline |
Return the Objective-C keyword ID for the this identifier.
For example, 'class' will return tok::objc_class if ObjC is enabled.
Definition at line 196 of file IdentifierTable.h.
References clang::tok::NUM_OBJC_KEYWORDS.
Referenced by clang::Token::getObjCKeywordID().
|
inline |
Definition at line 231 of file IdentifierTable.h.
Referenced by getDeclForLocalLookup(), isInterestingIdentifier(), and clang::serialization::reader::ASTIdentifierLookupTrait::ReadData().
tok::PPKeywordKind IdentifierInfo::getPPKeywordID | ( | ) | const |
Return the preprocessor keyword ID for this identifier.
For example, "define" will return tok::pp_define.
Definition at line 289 of file IdentifierTable.cpp.
Referenced by clang::Preprocessor::CheckEndOfDirective(), clang::Preprocessor::CheckMacroName(), DetectEOL(), clang::PreprocessingRecord::findMacroDefinition(), clang::Preprocessor::HandleDirective(), clang::format::FormatToken::is(), and revertIdentifierToTokenID().
|
inline |
If this is a source-language token (e.g.
'for'), this API can be used to cause the lexer to map identifiers to source-language tokens.
Definition at line 166 of file IdentifierTable.h.
Referenced by DiagnoseCallingConvCast(), isTargetEnvironment(), clang::PTHLexer::Lex(), clang::TokenLexer::Lex(), and clang::serialization::reader::ASTIdentifierLookupTrait::ReadData().
|
inline |
Returns true if this identifier was #defined to some value at any moment.
In this case there should be an entry for the identifier in the macro history table in Preprocessor.
Definition at line 159 of file IdentifierTable.h.
Referenced by checkConfigMacro(), clang::Preprocessor::getLocalMacroDirectiveHistory(), clang::Preprocessor::getMacroDefinitionAtLoc(), and isInterestingIdentifier().
|
inline |
Determine whether this identifier has changed since it was loaded from an AST file.
Definition at line 308 of file IdentifierTable.h.
|
inline |
Determine whether the frontend token information for this identifier has changed since it was loaded from an AST file.
Definition at line 320 of file IdentifierTable.h.
|
inline |
Return true if this identifier is #defined to some other value.
Definition at line 142 of file IdentifierTable.h.
Referenced by clang::Preprocessor::getLocalMacroDirective(), clang::Preprocessor::getMacroDefinition(), clang::Preprocessor::getMacroInfo(), clang::NSAPI::isMacroDefined(), clang::Preprocessor::isMacroDefined(), clang::Preprocessor::isMacroDefinedInLocalModule(), and operator<().
|
inline |
True if setNotBuiltin() was called.
Definition at line 205 of file IdentifierTable.h.
References clang::tok::NUM_OBJC_KEYWORDS.
Referenced by getDeclForLocalLookup(), isInterestingIdentifier(), and clang::serialization::reader::ASTIdentifierLookupTrait::ReadData().
|
inline |
True if revertTokenIDToIdentifier() was called.
Definition at line 169 of file IdentifierTable.h.
Referenced by getDeclForLocalLookup(), and isInterestingIdentifier().
bool IdentifierInfo::isCPlusPlusKeyword | ( | const LangOptions & | LangOpts | ) | const |
Return true if this token is a C++ keyword in the specified language.
Returns true if the identifier represents a C++ keyword in the specified language.
Definition at line 277 of file IdentifierTable.cpp.
Referenced by getMissingDeclaratorIdLoc(), and isCPlusPlusOperatorKeyword().
|
inline |
Definition at line 278 of file IdentifierTable.h.
References isCPlusPlusKeyword(), and isKeyword().
Referenced by clang::Preprocessor::CheckMacroName(), EvaluateValue(), getDeclForLocalLookup(), and clang::serialization::reader::ASTIdentifierLookupTrait::ReadData().
|
inline |
Return true if this identifier is an editor placeholder.
Editor placeholders are produced by the code-completion engine and are represented as characters between '<#' and '#>' in the source code. An example of auto-completed call with a placeholder parameter is shown below:
Definition at line 365 of file IdentifierTable.h.
References getName().
|
inline |
get/setExtension - Initialize information about whether or not this language token is an extension.
This controls extension warnings, and is only valid if a custom token ID is set.
Definition at line 237 of file IdentifierTable.h.
Referenced by getDeclForLocalLookup(), operator<(), and clang::serialization::reader::ASTIdentifierLookupTrait::ReadData().
|
inline |
Return true if the identifier in its current state was loaded from an AST file.
Definition at line 302 of file IdentifierTable.h.
Referenced by clang::Preprocessor::appendMacroDirective(), clang::Preprocessor::HandlePragmaPoison(), and markIdentifierFromAST().
|
inline |
is/setIsFutureCompatKeyword - Initialize information about whether or not this language token is a keyword in a newer or proposed Standard.
This controls compatibility warnings, and is only true when not parsing the corresponding Standard. Once a compatibility problem has been diagnosed with this keyword, the flag will be cleared.
Definition at line 251 of file IdentifierTable.h.
Referenced by getFutureCompatDiagKind(), and operator<().
|
inline |
Return true if the Preprocessor::HandleIdentifier must be called on a token of this identifier.
If this returns false, we know that HandleIdentifier will not affect the token.
Definition at line 298 of file IdentifierTable.h.
Referenced by clang::PTHLexer::Lex(), clang::TokenLexer::Lex(), and maybeDiagnoseUTF8Homoglyph().
bool IdentifierInfo::isKeyword | ( | const LangOptions & | LangOpts | ) | const |
Return true if this token is a keyword in the specified language.
Returns true if the identifier represents a keyword in the specified language.
Definition at line 265 of file IdentifierTable.cpp.
References getTokenKwStatus().
Referenced by DiagnoseCallingConvCast(), isCPlusPlusOperatorKeyword(), and shouldWarnOnMacroDef().
|
inline |
Determine whether this is the contextual keyword import
.
Definition at line 345 of file IdentifierTable.h.
Referenced by operator<().
|
inline |
Determine whether the information for this identifier is out of date with respect to the external source.
Definition at line 332 of file IdentifierTable.h.
Referenced by clang::HeaderFileInfo::getControllingMacro(), getFutureCompatDiagKind(), clang::Preprocessor::getLeafModuleMacros(), isTrivialSingleTokenExpansion(), and operator<().
|
inline |
Return true if this token has been poisoned.
Definition at line 271 of file IdentifierTable.h.
Referenced by getDeclForLocalLookup(), clang::Preprocessor::HandleIdentifier(), clang::Preprocessor::HandlePragmaPoison(), isInterestingIdentifier(), clang::TokenLexer::Lex(), clang::Preprocessor::MaybeHandlePoisonedIdentifier(), operator<(), and clang::VariadicMacroScopeGuard::VariadicMacroScopeGuard().
|
inline |
Return true if this is the identifier for the specified string.
This is intended to be used for string literals only: II->isStr("foo").
Definition at line 96 of file IdentifierTable.h.
References getLength(), and getNameStart().
Referenced by clang::Sema::ActOnClassPropertyRefExpr(), clang::Sema::ActOnStartNamespaceDef(), clang::Sema::ActOnUsingDirective(), clang::ento::AnyFunctionCall::argumentsMayEscape(), clang::ObjCMethodCall::argumentsMayEscape(), clang::Sema::ConversionToObjCStringLiteralCheck(), DetectEOL(), diagnoseRedundantPropertyNullability(), EvaluateValue(), findCapturingExpr(), clang::FunctionDecl::getMemoryFunctionKind(), handleObjCGCTypeAttr(), handleObjCOwnershipTypeAttr(), clang::TemplateDeclInstantiator::InstantiateEnumDefinition(), clang::TemplateDeclInstantiator::InstantiateTypedefNameDecl(), clang::Type::isAlignValT(), clang::CallExpr::isCallToStdMove(), isConfigurationPattern(), isDebuggingContext(), isEnableIf(), clang::TypoCorrection::isKeyword(), clang::Sema::isLibstdcxxEagerExceptionSpecHack(), isNamed(), isStd(), clang::Type::isStdByteType(), IsStdFunction(), clang::DeclContext::isStdNamespace(), isStreamCharSpecialization(), isWideStringLiteralFromMacro(), clang::Preprocessor::LexOnOffSwitch(), LookupMemberExpr(), ParseAlignPragma(), ParseLoopHintValue(), clang::CodeGen::CodeGenFunction::StartFunction(), and clang::CodeGen::CodeGenFunction::StartObjCMethod().
|
inline |
Return true if this is the identifier for the specified StringRef.
Definition at line 102 of file IdentifierTable.h.
References getLength(), and getNameStart().
|
inline |
Provide less than operator for lexicographical sorting.
Definition at line 370 of file IdentifierTable.h.
References getName(), hasMacroDefinition(), isExtensionToken(), isFutureCompatKeyword(), isModulesImport(), isOutOfDate(), and isPoisoned().
|
delete |
|
inline |
Revert the identifier to a non-builtin identifier.
We do this if the name of a known builtin library function is used to declare that function, but an unexpected type is specified.
Definition at line 212 of file IdentifierTable.h.
References setBuiltinID().
Referenced by clang::serialization::reader::ASTIdentifierLookupTrait::ReadData().
|
inline |
Definition at line 182 of file IdentifierTable.h.
References getPPKeywordID().
|
inline |
Revert TokenID to tok::identifier; used for GNU libstdc++ 4.2 compatibility.
TokenID is normally read-only but there are 2 instances where we revert it to tok::identifier for libstdc++ 4.2. Keep track of when this happens using this method so we can inform serialization about it.
Definition at line 177 of file IdentifierTable.h.
Referenced by clang::serialization::reader::ASTIdentifierLookupTrait::ReadData().
|
inline |
Definition at line 225 of file IdentifierTable.h.
References clang::tok::NUM_OBJC_KEYWORDS.
Referenced by clang::ASTImporter::Import(), and revertBuiltin().
|
inline |
Note that this identifier has changed since it was loaded from an AST file.
Definition at line 314 of file IdentifierTable.h.
Referenced by clang::Preprocessor::appendMacroDirective(), clang::Preprocessor::HandlePragmaPoison(), and markIdentifierFromAST().
|
inline |
Definition at line 291 of file IdentifierTable.h.
|
inline |
Note that the frontend token information for this identifier has changed since it was loaded from an AST file.
Definition at line 326 of file IdentifierTable.h.
|
inline |
Definition at line 145 of file IdentifierTable.h.
Referenced by clang::Preprocessor::addModuleMacro(), clang::Preprocessor::appendMacroDirective(), and clang::Preprocessor::setLoadedMacroDirective().
isCPlusPlusOperatorKeyword/setIsCPlusPlusOperatorKeyword controls whether this identifier is a C++ alternate representation of an operator.
Definition at line 275 of file IdentifierTable.h.
Referenced by AddCXXOperatorKeyword().
|
inline |
Definition at line 238 of file IdentifierTable.h.
Referenced by AddKeyword().
|
inline |
Definition at line 304 of file IdentifierTable.h.
Referenced by markIdentifierFromAST().
|
inline |
Definition at line 252 of file IdentifierTable.h.
Referenced by AddKeyword().
setIsPoisoned - Mark this identifier as poisoned.
After poisoning, the Preprocessor will emit an error every time this token is used.
Definition at line 262 of file IdentifierTable.h.
Referenced by clang::VariadicMacroScopeGuard::enterScope(), clang::VariadicMacroScopeGuard::exitScope(), clang::Preprocessor::HandlePragmaPoison(), clang::PoisonIdentifierRAIIObject::PoisonIdentifierRAIIObject(), clang::Preprocessor::PoisonSEHIdentifiers(), clang::serialization::reader::ASTIdentifierLookupTrait::ReadData(), and clang::PoisonIdentifierRAIIObject::~PoisonIdentifierRAIIObject().
|
inline |
Set whether this identifier is the contextual keyword import
.
Definition at line 348 of file IdentifierTable.h.
Referenced by clang::IdentifierTable::getOwn().
|
inline |
Definition at line 202 of file IdentifierTable.h.
|
inline |
Definition at line 232 of file IdentifierTable.h.
Referenced by clang::serialization::reader::ASTIdentifierLookupTrait::ReadData().
|
inline |
Set whether the information for this identifier is out of date with respect to the external source.
Definition at line 336 of file IdentifierTable.h.
Referenced by clang::ASTReader::markIdentifierUpToDate().
|
friend |
Definition at line 51 of file IdentifierTable.h.