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
|
|
|
*/
|
|
|
|
|
2009-07-11 16:44:04 +02:00
|
|
|
|
2009-07-13 13:35:33 +02:00
|
|
|
/**
|
|
|
|
*
|
|
|
|
* @mainpage Cppcheck
|
2010-03-07 16:25:37 +01:00
|
|
|
* @version 1.41
|
2009-07-13 13:35:33 +02:00
|
|
|
*
|
|
|
|
* @section overview_sec Overview
|
2009-07-16 15:32:07 +02:00
|
|
|
* Cppcheck is a simple tool for static analysis of C/C++ code.
|
2009-07-13 13:35:33 +02:00
|
|
|
*
|
2009-07-16 15:32:07 +02:00
|
|
|
* The method used is to first tokenize the source code and then analyse the token list.
|
|
|
|
* In the token list, the tokens are stored in plain text.
|
|
|
|
*
|
|
|
|
* The checks are written in C++. The checks are addons that can be easily added/removed.
|
|
|
|
*
|
|
|
|
* @section writing_checks_sec Writing a check
|
|
|
|
* Below is a simple example of a check that detect division with zero:
|
2009-07-13 13:35:33 +02:00
|
|
|
* @code
|
2009-07-11 16:44:04 +02:00
|
|
|
void CheckOther::checkZeroDivision()
|
|
|
|
{
|
2009-07-16 15:32:07 +02:00
|
|
|
// Iterate through all tokens in the token list
|
2009-07-11 16:44:04 +02:00
|
|
|
for (const Token *tok = _tokenizer->tokens(); tok; tok = tok->next())
|
|
|
|
{
|
|
|
|
if (Token::Match(tok, "/ 0"))
|
2009-07-16 15:32:07 +02:00
|
|
|
reportError(tok, Severity::error, "zerodiv", "Division by zero");
|
2009-07-11 16:44:04 +02:00
|
|
|
}
|
|
|
|
}
|
2009-07-13 13:35:33 +02:00
|
|
|
@endcode
|
|
|
|
*
|
2009-07-16 15:32:07 +02:00
|
|
|
* The function Token::Match is often used in the checks. Through it
|
|
|
|
* you can match tokens against patterns.
|
|
|
|
*
|
2009-07-18 09:11:02 +02:00
|
|
|
*
|
2009-07-16 15:32:07 +02:00
|
|
|
* @section checkclass_sec Creating a new check class from scratch
|
|
|
|
* %Check classes inherit from the Check class. The Check class specifies the interface that you must use.
|
|
|
|
* To integrate a check class into cppcheck all you need to do is:
|
|
|
|
* - Add your source file(s) so they are compiled into the executable.
|
|
|
|
* - Create an instance of the class (the Check::Check() constructor registers the class as an addon that Cppcheck then can use).
|
|
|
|
*
|
2009-07-18 09:11:02 +02:00
|
|
|
*
|
2009-07-16 15:32:07 +02:00
|
|
|
* @section embedding_sec Embedding Cppcheck
|
|
|
|
* Cppcheck is designed to be easily embeddable into other programs.
|
|
|
|
*
|
|
|
|
* The "src/main.cpp" and "src/cppcheckexecutor.*" files illustrate how cppcheck
|
|
|
|
* can be embedded into an application.
|
|
|
|
*
|
2009-07-18 09:11:02 +02:00
|
|
|
*
|
2009-07-16 15:32:07 +02:00
|
|
|
* @section detailed_overview_sec Detailed overview
|
|
|
|
* This happens when you execute cppcheck from the command line:
|
2009-07-18 09:11:02 +02:00
|
|
|
* -# CppCheckExecutor::check this function executes the Cppcheck
|
2009-07-16 15:32:07 +02:00
|
|
|
* -# CppCheck::parseFromArgs parse command line arguments
|
|
|
|
* - The Settings class is used to maintain settings
|
|
|
|
* - Use FileLister and command line arguments to get files to check
|
|
|
|
* -# ThreadExecutor create more instances of CppCheck if needed
|
|
|
|
* -# CppCheck::check is called for each file. It checks a single file
|
|
|
|
* -# Preprocess the file (through Preprocessor)
|
|
|
|
* - Comments are removed
|
|
|
|
* - Macros are expanded
|
|
|
|
* -# Tokenize the file (see Tokenizer)
|
|
|
|
* -# Run the runChecks of all check classes.
|
|
|
|
* -# Simplify the tokenlist (Tokenizer::simplifyTokenList)
|
|
|
|
* -# Run the runSimplifiedChecks of all check classes
|
|
|
|
*
|
|
|
|
* When errors are found, they are reported back to the CppCheckExecutor through the ErrorLogger interface
|
2009-07-11 16:44:04 +02:00
|
|
|
*/
|
|
|
|
|
|
|
|
|
2009-10-25 21:20:42 +01:00
|
|
|
#include "cppcheckexecutor.h"
|
2008-12-18 22:28:57 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Main function of cppcheck
|
|
|
|
*
|
|
|
|
* @param argc Passed to CppCheck::parseFromArgs()
|
|
|
|
* @param argv Passed to CppCheck::parseFromArgs()
|
2009-03-06 01:03:31 +01:00
|
|
|
* @return What CppCheckExecutor::check() returns.
|
2008-12-18 22:28:57 +01:00
|
|
|
*/
|
|
|
|
int main(int argc, char* argv[])
|
|
|
|
{
|
|
|
|
CppCheckExecutor exec;
|
2009-03-06 01:03:31 +01:00
|
|
|
return exec.check(argc, argv);
|
2008-12-18 22:28:57 +01:00
|
|
|
}
|