cppcheck/lib/cppcheck.h

254 lines
8.0 KiB
C
Raw Normal View History

2008-12-18 22:28:57 +01:00
/*
* Cppcheck - A tool for static C/C++ code analysis
2023-01-28 10:16:34 +01:00
* Copyright (C) 2007-2023 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 cppcheckH
#define cppcheckH
//---------------------------------------------------------------------------
2008-12-18 22:28:57 +01:00
2017-05-27 04:33:47 +02:00
#include "analyzerinfo.h"
#include "check.h"
2021-07-08 21:21:35 +02:00
#include "color.h"
#include "config.h"
#include "errorlogger.h"
2017-05-27 04:33:47 +02:00
#include "settings.h"
#include <cstddef>
#include <fstream> // IWYU pragma: keep
2020-05-23 07:16:49 +02:00
#include <functional>
2017-05-27 04:33:47 +02:00
#include <list>
#include <map>
#include <set>
2017-05-27 04:33:47 +02:00
#include <string>
#include <unordered_set>
#include <utility>
#include <vector>
2008-12-18 22:28:57 +01:00
2014-05-23 20:58:28 +02:00
class Tokenizer;
enum class SHOWTIME_MODES;
struct FileSettings;
2014-05-23 20:58:28 +02:00
/// @addtogroup Core
/// @{
2008-12-18 22:28:57 +01:00
/**
* @brief This is the base class which will use other classes to do
2008-12-18 22:28:57 +01:00
* static code analysis for C and C++ code to find possible
* errors or places that could be improved.
* Usage: See check() for more info.
*/
class CPPCHECKLIB CppCheck : ErrorLogger {
public:
using ExecuteCmdFn = std::function<int (std::string,std::vector<std::string>,std::string,std::string&)>;
/**
* @brief Constructor.
*/
CppCheck(ErrorLogger &errorLogger,
bool useGlobalSuppressions,
ExecuteCmdFn executeCommand);
2008-12-18 22:28:57 +01:00
/**
* @brief Destructor.
*/
~CppCheck() override;
2008-12-18 22:28:57 +01:00
/**
* @brief This starts the actual checking. Note that you must call
* parseFromArgs() or settings() and addFile() before calling this.
* @return amount of errors found or 0 if none were found.
*/
/**
2021-08-07 20:51:18 +02:00
* @brief Check the file.
* This function checks one given file for errors.
* @param path Path to the file to check.
* @return amount of errors found or 0 if none were found.
* @note You must set settings before calling this function (by calling
* settings()).
*/
unsigned int check(const std::string &path);
unsigned int check(const FileSettings &fs);
/**
2021-08-07 20:51:18 +02:00
* @brief Check the file.
* This function checks one "virtual" file. The file is not read from
* the disk but the content is given in @p content. In errors the @p path
* is used as a filename.
* @param path Path to the file to check.
* @param content File content as a string.
* @return amount of errors found or 0 if none were found.
* @note You must set settings before calling this function (by calling
* settings()).
*/
unsigned int check(const std::string &path, const std::string &content);
2008-12-18 22:28:57 +01:00
/**
* @brief Get reference to current settings.
* @return a reference to current settings
*/
Settings &settings();
/**
* @brief Returns current version number as a string.
* @return version, e.g. "1.38"
*/
static const char * version();
2009-10-17 11:34:17 +02:00
/**
* @brief Returns extra version info as a string.
* This is for returning extra version info, like Git commit id, build
* time/date etc.
* @return extra version info, e.g. "04d42151" (Git commit id).
*/
static const char * extraVersion();
/**
* @brief Call all "getErrorMessages" in all registered Check classes.
2010-12-15 18:45:53 +01:00
* Also print out XML header and footer.
*/
static void getErrorMessages(ErrorLogger &errorlogger);
2020-12-27 21:05:31 +01:00
void tooManyConfigsError(const std::string &file, const int numberOfConfigurations);
void purgedConfigurationMessage(const std::string &file, const std::string& configuration);
/** Analyse whole program, run this after all TUs has been scanned.
* This is deprecated and the plan is to remove this when
* .analyzeinfo is good enough.
* Return true if an error is reported.
*/
bool analyseWholeProgram();
2020-01-30 07:14:17 +01:00
/** Analyze all files using clang-tidy */
void analyseClangTidy(const FileSettings &fileSettings);
2020-01-30 07:14:17 +01:00
/** analyse whole program use .analyzeinfo files */
void analyseWholeProgram(const std::string &buildDir, const std::list<std::pair<std::string, std::size_t>> &files, const std::list<FileSettings>& fileSettings);
/** Check if the user wants to check for unused functions
* and if it's possible at all */
2016-10-28 12:10:19 +02:00
bool isUnusedFunctionCheckEnabled() const;
/** Remove *.ctu-info files */
void removeCtuInfoFiles(const std::list<std::pair<std::string, std::size_t>>& files, const std::list<FileSettings>& fileSettings); // cppcheck-suppress functionConst // has side effects
static void resetTimerResults();
static void printTimerResults(SHOWTIME_MODES mode);
private:
#ifdef HAVE_RULES
2019-03-17 08:19:56 +01:00
/** Are there "simple" rules */
bool hasRule(const std::string &tokenlist) const;
#endif
2019-03-17 08:19:56 +01:00
2015-01-12 23:09:17 +01:00
/** @brief There has been an internal error => Report information message */
void internalError(const std::string &filename, const std::string &msg);
2013-08-31 13:17:15 +02:00
/**
* @brief Check a file using stream
* @param filename file name
* @param cfgname cfg name
* @param fileStream stream the file content can be read from
* @return number of errors found
*/
unsigned int checkFile(const std::string& filename, const std::string &cfgname, std::istream* fileStream = nullptr);
/**
* @brief Check raw tokens
2017-08-21 21:13:01 +02:00
* @param tokenizer tokenizer instance
*/
void checkRawTokens(const Tokenizer &tokenizer);
/**
* @brief Check normal tokens
2017-08-21 21:13:01 +02:00
* @param tokenizer tokenizer instance
*/
void checkNormalTokens(const Tokenizer &tokenizer);
/**
* Execute addons
*/
void executeAddons(const std::vector<std::string>& files, const std::string& file0);
void executeAddons(const std::string &dumpFile, const std::string& file0);
2021-07-07 10:58:13 +02:00
/**
* Execute addons
*/
void executeAddonsWholeProgram(const std::list<std::pair<std::string, std::size_t>> &files);
2021-07-07 10:58:13 +02:00
#ifdef HAVE_RULES
/**
* @brief Execute rules, if any
* @param tokenlist token list to use (normal / simple)
* @param tokenizer tokenizer
*/
void executeRules(const std::string &tokenlist, const Tokenizer &tokenizer);
#endif
/**
* @brief Errors and warnings are directed here.
*
* @param msg Errors messages are normally in format
* "[filepath:line number] Message", e.g.
* "[main.cpp:4] Uninitialized member variable"
*/
void reportErr(const ErrorMessage &msg) override;
2008-12-18 22:28:57 +01:00
/**
* @brief Information about progress is directed here.
*
* @param outmsg Message to show, e.g. "Checking main.cpp..."
*/
void reportOut(const std::string &outmsg, Color c = Color::Reset) override;
2019-12-27 19:05:10 +01:00
// TODO: store hashes instead of the full messages
std::unordered_set<std::string> mErrorList;
Settings mSettings;
void reportProgress(const std::string &filename, const char stage[], const std::size_t value) override;
ErrorLogger &mErrorLogger;
2008-12-18 22:28:57 +01:00
/** @brief Current preprocessor configuration */
2018-06-17 07:40:13 +02:00
std::string mCurrentConfig;
using Location = std::pair<std::string, int>;
std::map<Location, std::set<std::string>> mLocationMacros; // What macros are used on a location?
unsigned int mExitCode{};
2018-06-17 07:29:07 +02:00
bool mUseGlobalSuppressions;
/** Are there too many configs? */
bool mTooManyConfigs{};
/** File info used for whole program analysis */
2018-06-17 07:36:05 +02:00
std::list<Check::FileInfo*> mFileInfo;
2016-10-29 12:18:11 +02:00
2018-06-17 07:31:34 +02:00
AnalyzerInformation mAnalyzerInformation;
/** Callback for executing a shell command (exe, args, output) */
ExecuteCmdFn mExecuteCommand;
std::ofstream mPlistFile;
2008-12-18 22:28:57 +01:00
};
/// @}
//---------------------------------------------------------------------------
#endif // cppcheckH