cppcheck/lib/checkunusedfunctions.h

128 lines
4.2 KiB
C
Raw Normal View History

2008-12-18 22:28:57 +01:00
/*
* Cppcheck - A tool for static C/C++ code analysis
2022-02-05 11:45:17 +01:00
* Copyright (C) 2007-2022 Cppcheck team.
2008-12-18 22:28:57 +01:00
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
2008-12-18 22:28:57 +01:00
*/
//---------------------------------------------------------------------------
#ifndef checkunusedfunctionsH
#define checkunusedfunctionsH
2008-12-18 22:28:57 +01:00
//---------------------------------------------------------------------------
#include "check.h"
2017-05-27 04:33:47 +02:00
#include "config.h"
#include <list>
#include <set>
#include <string>
#include <unordered_map>
2008-12-18 22:28:57 +01:00
2017-05-27 04:33:47 +02:00
class ErrorLogger;
class Function;
class Settings;
class Tokenizer;
namespace CTU {
class FileInfo;
}
/// @addtogroup Checks
2014-01-01 20:46:00 +01:00
/** @brief Check for functions never called */
/// @{
class CPPCHECKLIB CheckUnusedFunctions : public Check {
2008-12-18 22:28:57 +01:00
public:
2010-07-08 13:01:53 +02:00
/** @brief This constructor is used when registering the CheckUnusedFunctions */
2021-08-07 20:51:18 +02:00
CheckUnusedFunctions() : Check(myName()) {}
2008-12-18 22:28:57 +01:00
2010-07-08 13:01:53 +02:00
/** @brief This constructor is used when running checks. */
CheckUnusedFunctions(const Tokenizer *tokenizer, const Settings *settings, ErrorLogger *errorLogger)
2021-08-07 20:51:18 +02:00
: Check(myName(), tokenizer, settings, errorLogger) {}
2018-02-10 15:34:49 +01:00
static void clear() {
2018-06-17 18:58:27 +02:00
instance.mFunctions.clear();
instance.mFunctionCalls.clear();
2018-02-10 15:34:49 +01:00
}
2008-12-18 22:28:57 +01:00
// Parse current tokens and determine..
// * Check what functions are used
// * What functions are declared
2018-02-10 15:34:49 +01:00
void parseTokens(const Tokenizer &tokenizer, const char FileName[], const Settings *settings);
2008-12-18 22:28:57 +01:00
// Return true if an error is reported.
bool check(ErrorLogger * const errorLogger, const Settings& settings) const;
2008-12-18 22:28:57 +01:00
/** @brief Parse current TU and extract file info */
Check::FileInfo *getFileInfo(const Tokenizer *tokenizer, const Settings *settings) const override;
/** @brief Analyse all file infos for all TU */
bool analyseWholeProgram(const CTU::FileInfo *ctu, const std::list<Check::FileInfo*> &fileInfo, const Settings& settings, ErrorLogger &errorLogger) override;
static CheckUnusedFunctions instance;
std::string analyzerInfo() const;
2016-10-29 12:18:11 +02:00
/** @brief Combine and analyze all analyzerInfos for all TUs */
static void analyseWholeProgram(const Settings &settings, ErrorLogger * const errorLogger, const std::string &buildDir);
2008-12-18 22:28:57 +01:00
private:
void getErrorMessages(ErrorLogger *errorLogger, const Settings * /*settings*/) const override {
CheckUnusedFunctions::unusedFunctionError(errorLogger, emptyString, 0, "funcName");
}
void runChecks(const Tokenizer * /*tokenizer*/, const Settings * /*settings*/, ErrorLogger * /*errorLogger*/) override {}
2019-03-16 09:17:50 +01:00
/**
* Dummy implementation, just to provide error for --errorlist
*/
static void unusedFunctionError(ErrorLogger * const errorLogger,
const std::string &filename, unsigned int lineNumber,
const std::string &funcname);
2014-11-20 14:20:09 +01:00
static std::string myName() {
return "Unused functions";
}
std::string classInfo() const override {
return "Check for functions that are never called\n";
}
class CPPCHECKLIB FunctionUsage {
2008-12-18 22:28:57 +01:00
public:
2021-08-07 20:51:18 +02:00
FunctionUsage() : lineNumber(0), usedSameFile(false), usedOtherFile(false) {}
2008-12-18 22:28:57 +01:00
std::string filename;
unsigned int lineNumber;
2021-08-07 20:51:18 +02:00
bool usedSameFile;
bool usedOtherFile;
2008-12-18 22:28:57 +01:00
};
std::unordered_map<std::string, FunctionUsage> mFunctions;
class CPPCHECKLIB FunctionDecl {
public:
explicit FunctionDecl(const Function *f);
std::string functionName;
unsigned int lineNumber;
};
2018-06-17 18:58:27 +02:00
std::list<FunctionDecl> mFunctionDecl;
std::set<std::string> mFunctionCalls;
2008-12-18 22:28:57 +01:00
};
/// @}
2008-12-18 22:28:57 +01:00
//---------------------------------------------------------------------------
#endif // checkunusedfunctionsH