/**************************************************************************** ** ** Copyright (C) 2017 The Qt Company Ltd. ** Contact: https://www.qt.io/licensing/ ** ** This file is part of Qt Creator. ** ** Commercial License Usage ** Licensees holding valid commercial Qt licenses may use this file in ** accordance with the commercial license agreement provided with the ** Software or, alternatively, in accordance with the terms contained in ** a written agreement between you and The Qt Company. For licensing terms ** and conditions see https://www.qt.io/terms-conditions. For further ** information use the contact form at https://www.qt.io/contact-us. ** ** GNU General Public License Usage ** Alternatively, this file may be used under the terms of the GNU ** General Public License version 3 as published by the Free Software ** Foundation with exceptions as appearing in the file LICENSE.GPL3-EXCEPT ** included in the packaging of this file. Please review the following ** information to ensure the GNU General Public License requirements will ** be met: https://www.gnu.org/licenses/gpl-3.0.html. ** ****************************************************************************/ #pragma once #include "filestatus.h" #include "symbolsvisitorbase.h" #include "sourcedependency.h" #include "sourcelocationsutils.h" #include "sourcelocationentry.h" #include "symbolentry.h" #include "usedmacro.h" #include #include #include #include #include namespace ClangBackEnd { class CollectMacrosPreprocessorCallbacks final : public clang::PPCallbacks, public SymbolsVisitorBase { public: CollectMacrosPreprocessorCallbacks(SymbolEntries &symbolEntries, SourceLocationEntries &sourceLocationEntries, FilePathIds &sourceFiles, UsedMacros &usedMacros, FileStatuses &fileStatuses, SourceDependencies &sourceDependencies, FilePathCachingInterface &filePathCache, const clang::SourceManager &sourceManager, std::shared_ptr &&preprocessor) : SymbolsVisitorBase(filePathCache, &sourceManager), m_preprocessor(std::move(preprocessor)), m_sourceDependencies(sourceDependencies), m_symbolEntries(symbolEntries), m_sourceLocationEntries(sourceLocationEntries), m_sourceFiles(sourceFiles), m_usedMacros(usedMacros), m_fileStatuses(fileStatuses) { } void FileChanged(clang::SourceLocation sourceLocation, clang::PPCallbacks::FileChangeReason reason, clang::SrcMgr::CharacteristicKind, clang::FileID) { if (reason == clang::PPCallbacks::EnterFile) { const clang::FileEntry *fileEntry = m_sourceManager->getFileEntryForID( m_sourceManager->getFileID(sourceLocation)); if (fileEntry) { addFileStatus(fileEntry); addSourceFile(fileEntry); } } } void InclusionDirective(clang::SourceLocation hashLocation, const clang::Token &/*includeToken*/, llvm::StringRef /*fileName*/, bool /*isAngled*/, clang::CharSourceRange /*fileNameRange*/, const clang::FileEntry *file, llvm::StringRef /*searchPath*/, llvm::StringRef /*relativePath*/, const clang::Module * /*imported*/) override { if (!m_skipInclude && file) addSourceDependency(file, hashLocation); m_skipInclude = false; } bool FileNotFound(clang::StringRef /*fileNameRef*/, clang::SmallVectorImpl &/*recoveryPath*/) override { m_skipInclude = true; return true; } void Ifndef(clang::SourceLocation, const clang::Token ¯oNameToken, const clang::MacroDefinition ¯oDefinition) override { addUsedMacro(macroNameToken, macroDefinition); addMacroAsSymbol(macroNameToken, firstMacroInfo(macroDefinition.getLocalDirective()), SymbolType::MacroUsage); } void Ifdef(clang::SourceLocation, const clang::Token ¯oNameToken, const clang::MacroDefinition ¯oDefinition) override { addUsedMacro( macroNameToken, macroDefinition); addMacroAsSymbol(macroNameToken, firstMacroInfo(macroDefinition.getLocalDirective()), SymbolType::MacroUsage); } void Defined(const clang::Token ¯oNameToken, const clang::MacroDefinition ¯oDefinition, clang::SourceRange) override { addUsedMacro(macroNameToken, macroDefinition); addMacroAsSymbol(macroNameToken, firstMacroInfo(macroDefinition.getLocalDirective()), SymbolType::MacroUsage); } void MacroDefined(const clang::Token ¯oNameToken, const clang::MacroDirective *macroDirective) override { addMacroAsSymbol(macroNameToken, firstMacroInfo(macroDirective), SymbolType::MacroDefinition); } void MacroUndefined(const clang::Token ¯oNameToken, const clang::MacroDefinition ¯oDefinition, const clang::MacroDirective *) override { addMacroAsSymbol(macroNameToken, firstMacroInfo(macroDefinition.getLocalDirective()), SymbolType::MacroUndefinition); } void MacroExpands(const clang::Token ¯oNameToken, const clang::MacroDefinition ¯oDefinition, clang::SourceRange, const clang::MacroArgs *) override { addUsedMacro(macroNameToken, macroDefinition); addMacroAsSymbol(macroNameToken, firstMacroInfo(macroDefinition.getLocalDirective()), SymbolType::MacroUsage); } void EndOfMainFile() override { filterOutHeaderGuards(); mergeUsedMacros(); } void filterOutHeaderGuards() { auto partitionPoint = std::stable_partition(m_maybeUsedMacros.begin(), m_maybeUsedMacros.end(), [&] (const UsedMacro &usedMacro) { llvm::StringRef id{usedMacro.macroName.data(), usedMacro.macroName.size()}; clang::IdentifierInfo &identifierInfo = m_preprocessor->getIdentifierTable().get(id); clang::MacroInfo *macroInfo = m_preprocessor->getMacroInfo(&identifierInfo); return !macroInfo || !macroInfo->isUsedForHeaderGuard(); }); m_maybeUsedMacros.erase(partitionPoint, m_maybeUsedMacros.end()); } void mergeUsedMacros() { m_usedMacros.reserve(m_usedMacros.size() + m_maybeUsedMacros.size()); auto insertionPoint = m_usedMacros.insert(m_usedMacros.end(), m_maybeUsedMacros.begin(), m_maybeUsedMacros.end()); std::inplace_merge(m_usedMacros.begin(), insertionPoint, m_usedMacros.end()); } static void addUsedMacro(UsedMacro &&usedMacro, UsedMacros &usedMacros) { auto found = std::lower_bound(usedMacros.begin(), usedMacros.end(), usedMacro); if (found == usedMacros.end() || *found != usedMacro) usedMacros.insert(found, std::move(usedMacro)); } void addUsedMacro(const clang::Token ¯oNameToken, const clang::MacroDefinition ¯oDefinition) { clang::MacroInfo *macroInfo = macroDefinition.getMacroInfo(); UsedMacro usedMacro{macroNameToken.getIdentifierInfo()->getName(), filePathId(macroNameToken.getLocation())}; if (macroInfo) addUsedMacro(std::move(usedMacro), m_usedMacros); else addUsedMacro(std::move(usedMacro), m_maybeUsedMacros); } static const clang::MacroInfo *firstMacroInfo(const clang::MacroDirective *macroDirective) { if (macroDirective) { const clang::MacroDirective *previousDirective = macroDirective; do { macroDirective = previousDirective; previousDirective = macroDirective->getPrevious(); } while (previousDirective); return macroDirective->getMacroInfo(); } return nullptr; } void addMacroAsSymbol(const clang::Token ¯oNameToken, const clang::MacroInfo *macroInfo, SymbolType symbolType) { clang::SourceLocation sourceLocation = macroNameToken.getLocation(); if (macroInfo && sourceLocation.isFileID()) { FilePathId fileId = filePathId(sourceLocation); if (fileId.isValid()) { auto macroName = macroNameToken.getIdentifierInfo()->getName(); SymbolIndex globalId = toSymbolIndex(macroInfo); auto found = m_symbolEntries.find(globalId); if (found == m_symbolEntries.end()) { Utils::optional usr = generateUSR(macroName, sourceLocation); if (usr) { m_symbolEntries.emplace(std::piecewise_construct, std::forward_as_tuple(globalId), std::forward_as_tuple(std::move(usr.value()), macroName)); } } m_sourceLocationEntries.emplace_back(globalId, fileId, lineColum(sourceLocation), symbolType); } } } void addSourceFile(const clang::FileEntry *fileEntry) { auto id = filePathId(fileEntry); auto found = std::lower_bound(m_sourceFiles.begin(), m_sourceFiles.end(), id); if (found == m_sourceFiles.end() || *found != id) m_sourceFiles.insert(found, id); } void addFileStatus(const clang::FileEntry *fileEntry) { auto id = filePathId(fileEntry); auto found = std::lower_bound(m_fileStatuses.begin(), m_fileStatuses.end(), id, [] (const auto &first, const auto &second) { return first.filePathId < second; }); if (found == m_fileStatuses.end() || found->filePathId != id) { m_fileStatuses.emplace(found, id, fileEntry->getSize(), fileEntry->getModificationTime(), fileEntry->isInPCH()); } } void addSourceDependency(const clang::FileEntry *file, clang::SourceLocation includeLocation) { auto includeFilePathId = filePathId(includeLocation); auto includedFilePathId = filePathId(file); m_sourceDependencies.emplace_back(includeFilePathId, includedFilePathId); } private: UsedMacros m_maybeUsedMacros; std::shared_ptr m_preprocessor; SourceDependencies &m_sourceDependencies; SymbolEntries &m_symbolEntries; SourceLocationEntries &m_sourceLocationEntries; FilePathIds &m_sourceFiles; UsedMacros &m_usedMacros; FileStatuses &m_fileStatuses; bool m_skipInclude = false; }; } // namespace ClangBackEnd