2008-12-18 22:28:57 +01:00
|
|
|
/*
|
2009-01-21 21:04:20 +01:00
|
|
|
* Cppcheck - A tool for static C/C++ code analysis
|
2009-05-30 07:48:12 +02:00
|
|
|
* Copyright (C) 2007-2009 Daniel Marjamäki and 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
|
2009-09-27 17:08:31 +02:00
|
|
|
* along with this program. If not, see <http://www.gnu.org/licenses/>.
|
2008-12-18 22:28:57 +01:00
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef CPPCHECK_H
|
|
|
|
#define CPPCHECK_H
|
|
|
|
|
|
|
|
#include <string>
|
|
|
|
#include <list>
|
|
|
|
#include <sstream>
|
|
|
|
#include <vector>
|
|
|
|
#include <map>
|
|
|
|
#include "settings.h"
|
|
|
|
#include "errorlogger.h"
|
2009-06-07 22:12:20 +02:00
|
|
|
#include "checkunusedfunctions.h"
|
2008-12-18 22:28:57 +01:00
|
|
|
|
2009-07-17 10:49:01 +02:00
|
|
|
/// @addtogroup Core
|
|
|
|
/// @{
|
|
|
|
|
2008-12-18 22:28:57 +01:00
|
|
|
/**
|
|
|
|
* This is the base class which will use other classes to do
|
|
|
|
* 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 CppCheck : public ErrorLogger
|
|
|
|
{
|
2009-01-05 16:49:57 +01:00
|
|
|
public:
|
|
|
|
/**
|
|
|
|
* Constructor.
|
|
|
|
*/
|
|
|
|
CppCheck(ErrorLogger &errorLogger);
|
2008-12-18 22:28:57 +01:00
|
|
|
|
2009-01-05 16:49:57 +01:00
|
|
|
/**
|
|
|
|
* Destructor.
|
|
|
|
*/
|
|
|
|
virtual ~CppCheck();
|
2008-12-18 22:28:57 +01:00
|
|
|
|
2009-01-05 16:49:57 +01:00
|
|
|
/**
|
|
|
|
* This starts the actual checking. Note that you must call
|
|
|
|
* parseFromArgs() or settings() and addFile() before calling this.
|
2009-01-08 22:30:25 +01:00
|
|
|
* @return amount of errors found or 0 if none were found.
|
2009-01-05 16:49:57 +01:00
|
|
|
*/
|
2009-01-08 22:30:25 +01:00
|
|
|
unsigned int check();
|
2008-12-18 22:28:57 +01:00
|
|
|
|
2009-01-05 16:49:57 +01:00
|
|
|
/**
|
|
|
|
* Adjust the settings before doing the check. E.g. show only
|
|
|
|
* actual bugs or also coding style issues.
|
|
|
|
*
|
|
|
|
* @param settings New settings which will overwrite the old.
|
|
|
|
*/
|
|
|
|
void settings(const Settings &settings);
|
2008-12-18 22:28:57 +01:00
|
|
|
|
2009-02-09 21:51:04 +01:00
|
|
|
/**
|
|
|
|
* Get copy of current settings.
|
|
|
|
* @return a copy of current settings
|
|
|
|
*/
|
|
|
|
Settings settings() const;
|
|
|
|
|
2009-01-05 16:49:57 +01:00
|
|
|
/**
|
|
|
|
* Add new file to be checked.
|
|
|
|
*
|
|
|
|
* @param path Relative or absolute path to the file to be checked,
|
|
|
|
* e.g. "cppcheck.cpp". Note that only source files (.c, .cc or .cpp)
|
2009-02-22 12:17:17 +01:00
|
|
|
* should be added to the list. Include files are gathered automatically.
|
|
|
|
* You can also give path, e.g. "src/" which will be scanned for source
|
|
|
|
* files recursively.
|
2009-01-05 16:49:57 +01:00
|
|
|
*/
|
|
|
|
void addFile(const std::string &path);
|
2008-12-18 22:28:57 +01:00
|
|
|
|
2009-01-05 16:49:57 +01:00
|
|
|
/**
|
|
|
|
* Add new unreal file to be checked.
|
|
|
|
*
|
|
|
|
* @param path File name (used for error reporting).
|
|
|
|
* @param content If the file would be a real file, this should be
|
|
|
|
* the content of the file.
|
|
|
|
*/
|
|
|
|
void addFile(const std::string &path, const std::string &content);
|
2008-12-18 22:28:57 +01:00
|
|
|
|
2009-02-27 20:39:50 +01:00
|
|
|
/**
|
|
|
|
* Remove all files added with addFile() and parseFromArgs().
|
|
|
|
*/
|
|
|
|
void clearFiles();
|
|
|
|
|
2009-01-05 16:49:57 +01:00
|
|
|
/**
|
|
|
|
* Parse command line args and get settings and file lists
|
|
|
|
* from there.
|
|
|
|
*
|
|
|
|
* @param argc argc from main()
|
|
|
|
* @param argv argv from main()
|
2009-10-17 08:19:37 +02:00
|
|
|
* @throw std::runtime_error when errors are found in the input
|
2009-01-05 16:49:57 +01:00
|
|
|
*/
|
2009-10-17 08:19:37 +02:00
|
|
|
void parseFromArgs(int argc, const char* const argv[]);
|
2008-12-18 22:28:57 +01:00
|
|
|
|
2009-10-25 21:06:58 +01:00
|
|
|
/**
|
|
|
|
* 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
|
|
|
|
2009-02-19 23:21:18 +01:00
|
|
|
const std::vector<std::string> &filenames() const;
|
|
|
|
|
|
|
|
virtual void reportStatus(unsigned int index, unsigned int max);
|
|
|
|
|
2009-01-05 16:49:57 +01:00
|
|
|
private:
|
|
|
|
void checkFile(const std::string &code, const char FileName[]);
|
2008-12-18 22:28:57 +01:00
|
|
|
|
2009-01-05 16:49:57 +01:00
|
|
|
/**
|
|
|
|
* Errors and warnings are directed here.
|
|
|
|
*
|
2009-06-20 11:54:49 +02:00
|
|
|
* @param msg Errors messages are normally in format
|
2009-01-05 16:49:57 +01:00
|
|
|
* "[filepath:line number] Message", e.g.
|
|
|
|
* "[main.cpp:4] Uninitialized member variable"
|
|
|
|
*/
|
2009-02-10 22:51:52 +01:00
|
|
|
virtual void reportErr(const ErrorLogger::ErrorMessage &msg);
|
2008-12-18 22:28:57 +01:00
|
|
|
|
2009-01-05 16:49:57 +01:00
|
|
|
/**
|
|
|
|
* Information about progress is directed here.
|
|
|
|
*
|
2009-06-20 11:54:49 +02:00
|
|
|
* @param outmsg Message to show, e.g. "Checking main.cpp..."
|
2009-01-05 16:49:57 +01:00
|
|
|
*/
|
|
|
|
virtual void reportOut(const std::string &outmsg);
|
2008-12-18 22:28:57 +01:00
|
|
|
|
2009-01-05 16:49:57 +01:00
|
|
|
std::list<std::string> _errorList;
|
|
|
|
std::ostringstream _errout;
|
|
|
|
Settings _settings;
|
|
|
|
std::vector<std::string> _filenames;
|
|
|
|
/** Key is file name, and value is the content of the file */
|
|
|
|
std::map<std::string, std::string> _fileContents;
|
2009-06-07 22:12:20 +02:00
|
|
|
CheckUnusedFunctions _checkUnusedFunctions;
|
2009-01-05 16:49:57 +01:00
|
|
|
ErrorLogger *_errorLogger;
|
2008-12-18 22:28:57 +01:00
|
|
|
|
2009-01-05 16:49:57 +01:00
|
|
|
/** Current configuration */
|
|
|
|
std::string cfg;
|
2009-01-22 20:59:50 +01:00
|
|
|
|
2009-02-01 19:00:47 +01:00
|
|
|
std::list<std::string> _xmllist;
|
2008-12-18 22:28:57 +01:00
|
|
|
};
|
|
|
|
|
2009-07-17 10:49:01 +02:00
|
|
|
/// @}
|
|
|
|
|
2008-12-18 22:28:57 +01:00
|
|
|
#endif // CPPCHECK_H
|