2010-01-16 08:47:46 +01:00
|
|
|
/*
|
|
|
|
* Cppcheck - A tool for static C/C++ code analysis
|
2010-04-13 21:23:17 +02:00
|
|
|
* Copyright (C) 2007-2010 Daniel Marjamäki and Cppcheck team.
|
2010-01-16 08:47:46 +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/>.
|
|
|
|
*/
|
|
|
|
|
|
|
|
//---------------------------------------------------------------------------
|
|
|
|
#ifndef CheckClassH
|
|
|
|
#define CheckClassH
|
|
|
|
//---------------------------------------------------------------------------
|
|
|
|
|
|
|
|
#include "check.h"
|
|
|
|
#include "settings.h"
|
|
|
|
|
|
|
|
class Token;
|
|
|
|
|
|
|
|
/// @addtogroup Checks
|
|
|
|
/// @{
|
|
|
|
|
|
|
|
|
2010-01-22 19:29:24 +01:00
|
|
|
/** @brief %Check classes. Uninitialized member variables, non-conforming operators, missing virtual destructor, etc */
|
2010-01-16 08:47:46 +01:00
|
|
|
class CheckClass : public Check
|
|
|
|
{
|
|
|
|
public:
|
2010-01-22 19:29:24 +01:00
|
|
|
/** @brief This constructor is used when registering the CheckClass */
|
2010-01-16 08:47:46 +01:00
|
|
|
CheckClass() : Check()
|
|
|
|
{ }
|
|
|
|
|
2010-03-17 22:16:18 +01:00
|
|
|
/** @brief This constructor is used when running checks. */
|
2010-01-16 08:47:46 +01:00
|
|
|
CheckClass(const Tokenizer *tokenizer, const Settings *settings, ErrorLogger *errorLogger)
|
2010-04-15 20:08:51 +02:00
|
|
|
: Check(tokenizer, settings, errorLogger)
|
2010-01-16 08:47:46 +01:00
|
|
|
{ }
|
|
|
|
|
2010-03-13 21:42:59 +01:00
|
|
|
/** @brief Run checks on the normal token list */
|
2010-01-16 08:47:46 +01:00
|
|
|
void runChecks(const Tokenizer *tokenizer, const Settings *settings, ErrorLogger *errorLogger)
|
|
|
|
{
|
|
|
|
CheckClass checkClass(tokenizer, settings, errorLogger);
|
2010-03-13 21:42:59 +01:00
|
|
|
|
|
|
|
// can't be a simplified check .. the 'sizeof' is used.
|
2010-01-16 08:47:46 +01:00
|
|
|
checkClass.noMemset();
|
|
|
|
}
|
|
|
|
|
2010-03-13 21:42:59 +01:00
|
|
|
/** @brief Run checks on the simplified token list */
|
2010-01-16 08:47:46 +01:00
|
|
|
void runSimplifiedChecks(const Tokenizer *tokenizer, const Settings *settings, ErrorLogger *errorLogger)
|
|
|
|
{
|
|
|
|
CheckClass checkClass(tokenizer, settings, errorLogger);
|
|
|
|
|
2010-04-21 08:38:25 +02:00
|
|
|
// Coding style checks
|
|
|
|
checkClass.constructors();
|
|
|
|
checkClass.operatorEq();
|
|
|
|
checkClass.privateFunctions();
|
|
|
|
checkClass.operatorEqRetRefThis();
|
|
|
|
checkClass.thisSubtraction();
|
|
|
|
checkClass.operatorEqToSelf();
|
|
|
|
|
2010-01-16 08:47:46 +01:00
|
|
|
checkClass.virtualDestructor();
|
2010-01-23 09:38:35 +01:00
|
|
|
checkClass.checkConst();
|
2010-01-16 08:47:46 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
|
2010-01-22 19:29:24 +01:00
|
|
|
/** @brief %Check that all class constructors are ok */
|
2010-01-16 08:47:46 +01:00
|
|
|
void constructors();
|
|
|
|
|
2010-01-22 19:29:24 +01:00
|
|
|
/** @brief %Check that all private functions are called */
|
2010-01-16 08:47:46 +01:00
|
|
|
void privateFunctions();
|
|
|
|
|
2010-01-22 19:29:24 +01:00
|
|
|
/**
|
|
|
|
* @brief %Check that the memsets are valid.
|
2010-03-13 21:42:59 +01:00
|
|
|
* The 'memset' function can do dangerous things if used wrong. If it
|
|
|
|
* is used on STL containers for instance it will clear all its data
|
|
|
|
* and then the STL container may leak memory or worse have an invalid state.
|
|
|
|
* It can also overwrite the virtual table.
|
2010-01-22 19:29:24 +01:00
|
|
|
* Important: The checking doesn't work on simplified tokens list.
|
|
|
|
*/
|
2010-01-16 08:47:46 +01:00
|
|
|
void noMemset();
|
|
|
|
|
2010-03-17 22:16:18 +01:00
|
|
|
/** @brief 'operator=' should return something. */
|
2010-01-22 19:29:24 +01:00
|
|
|
void operatorEq();
|
2010-01-16 08:47:46 +01:00
|
|
|
|
2010-01-22 19:29:24 +01:00
|
|
|
/** @brief 'operator=' should return reference to *this */
|
2010-01-16 08:47:46 +01:00
|
|
|
void operatorEqRetRefThis(); // Warning upon no "return *this;"
|
|
|
|
|
2010-01-22 19:29:24 +01:00
|
|
|
/** @brief 'operator=' should check for assignment to self */
|
2010-01-16 08:47:46 +01:00
|
|
|
void operatorEqToSelf(); // Warning upon no check for assignment to self
|
|
|
|
|
2010-01-22 19:29:24 +01:00
|
|
|
/** @brief The destructor in a base class should be virtual */
|
2010-01-16 08:47:46 +01:00
|
|
|
void virtualDestructor();
|
|
|
|
|
2010-01-22 19:29:24 +01:00
|
|
|
/** @brief warn for "this-x". The indented code may be "this->x" */
|
2010-01-16 08:47:46 +01:00
|
|
|
void thisSubtraction();
|
2010-01-23 09:19:22 +01:00
|
|
|
|
|
|
|
/** @brief can member function be const? */
|
|
|
|
void checkConst();
|
2010-01-16 08:47:46 +01:00
|
|
|
private:
|
2010-01-22 19:29:24 +01:00
|
|
|
|
|
|
|
/** @brief Information about a member variable. Used when checking for uninitialized variables */
|
2010-01-16 08:47:46 +01:00
|
|
|
class Var
|
|
|
|
{
|
|
|
|
public:
|
2010-04-02 08:02:47 +02:00
|
|
|
Var(const std::string &name_, bool init_ = false, bool priv_ = false, bool mutable_ = false, bool static_ = false, Var *next_ = 0)
|
2010-04-15 20:08:51 +02:00
|
|
|
: name(name_),
|
|
|
|
init(init_),
|
|
|
|
priv(priv_),
|
|
|
|
isMutable(mutable_),
|
|
|
|
isStatic(static_),
|
|
|
|
next(next_)
|
2010-01-16 08:47:46 +01:00
|
|
|
{
|
|
|
|
}
|
|
|
|
|
2010-01-22 19:29:24 +01:00
|
|
|
/** @brief name of variable */
|
2010-02-14 19:58:17 +01:00
|
|
|
const std::string name;
|
2010-01-22 19:29:24 +01:00
|
|
|
|
|
|
|
/** @brief has this variable been initialized? */
|
2010-01-16 08:47:46 +01:00
|
|
|
bool init;
|
2010-01-22 19:29:24 +01:00
|
|
|
|
|
|
|
/** @brief is this variable declared in the private section? */
|
2010-01-16 08:47:46 +01:00
|
|
|
bool priv;
|
2010-01-22 19:29:24 +01:00
|
|
|
|
2010-03-26 19:06:00 +01:00
|
|
|
/** @brief is this variable mutable? */
|
|
|
|
bool isMutable;
|
|
|
|
|
2010-04-02 08:02:47 +02:00
|
|
|
/** @brief is this variable static? */
|
|
|
|
bool isStatic;
|
|
|
|
|
2010-01-22 19:29:24 +01:00
|
|
|
/** @brief next Var item */
|
2010-01-16 08:47:46 +01:00
|
|
|
Var *next;
|
2010-04-13 19:25:08 +02:00
|
|
|
|
|
|
|
private:
|
|
|
|
Var& operator=(const Var&); // disallow assignments
|
2010-01-16 08:47:46 +01:00
|
|
|
};
|
|
|
|
|
2010-01-22 19:29:24 +01:00
|
|
|
/**
|
|
|
|
* @brief parse a scope for a constructor or member function and set the "init" flags in the provided varlist
|
|
|
|
* @param tok1 pointer to class declaration
|
|
|
|
* @param ftok pointer to the function that should be checked
|
|
|
|
* @param varlist variable list (the "init" flag will be set in these variables)
|
|
|
|
* @param classname name of class
|
|
|
|
* @param callstack the function doesn't look into recursive function calls.
|
|
|
|
* @param isStruct if this is a struct instead of a class
|
|
|
|
*/
|
2010-02-14 19:58:17 +01:00
|
|
|
void initializeVarList(const Token *tok1, const Token *ftok, Var *varlist, const std::string &classname, std::list<std::string> &callstack, bool isStruct);
|
2010-01-22 19:29:24 +01:00
|
|
|
|
|
|
|
/** @brief initialize a variable in the varlist */
|
2010-02-14 19:58:17 +01:00
|
|
|
void initVar(Var *varlist, const std::string &varname);
|
2010-01-22 19:29:24 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief get varlist from a class definition
|
|
|
|
* @param tok1 pointer to class definition
|
|
|
|
* @param withClasses if class variables should be extracted too.
|
|
|
|
* @param isStruct is this a struct?
|
|
|
|
*/
|
2010-01-16 08:47:46 +01:00
|
|
|
Var *getVarList(const Token *tok1, bool withClasses, bool isStruct);
|
|
|
|
|
2010-03-05 17:06:25 +01:00
|
|
|
bool sameFunc(int nest, const Token *firstEnd, const Token *secondEnd);
|
2010-03-28 11:46:42 +02:00
|
|
|
bool isMemberFunc(const Token *tok);
|
2010-04-01 16:59:35 +02:00
|
|
|
bool isMemberVar(const std::string &classname, const Var *varlist, const Token *tok);
|
|
|
|
bool checkConstFunc(const std::string &classname, const Var *varlist, const Token *tok);
|
2010-03-05 17:06:25 +01:00
|
|
|
|
2010-04-03 09:17:16 +02:00
|
|
|
/**
|
|
|
|
* @brief Helper function for operatorEqRetRefThis that checks if there are errors
|
|
|
|
* @param tok The "operator" token in a operator=(.. function
|
|
|
|
* @param classname Name of class
|
|
|
|
*/
|
|
|
|
void operatorEqRetRefThis_finderr(const Token *tok, const std::string &classname);
|
|
|
|
|
2010-01-16 08:47:46 +01:00
|
|
|
// Reporting errors..
|
|
|
|
void noConstructorError(const Token *tok, const std::string &classname, bool isStruct);
|
2010-05-16 14:43:42 +02:00
|
|
|
void uninitVarError(const Token *tok, const std::string &classname, const std::string &varname);
|
2010-01-16 08:47:46 +01:00
|
|
|
void operatorEqVarError(const Token *tok, const std::string &classname, const std::string &varname);
|
|
|
|
void unusedPrivateFunctionError(const Token *tok, const std::string &classname, const std::string &funcname);
|
|
|
|
void memsetClassError(const Token *tok, const std::string &memfunc);
|
|
|
|
void memsetStructError(const Token *tok, const std::string &memfunc, const std::string &classname);
|
|
|
|
void operatorEqReturnError(const Token *tok);
|
|
|
|
void virtualDestructorError(const Token *tok, const std::string &Base, const std::string &Derived);
|
|
|
|
void thisSubtractionError(const Token *tok);
|
|
|
|
void operatorEqRetRefThisError(const Token *tok);
|
|
|
|
void operatorEqToSelfError(const Token *tok);
|
|
|
|
|
2010-01-23 09:19:22 +01:00
|
|
|
void checkConstError(const Token *tok, const std::string &classname, const std::string &funcname);
|
2010-03-10 07:47:01 +01:00
|
|
|
void checkConstError2(const Token *tok1, const Token *tok2, const std::string &classname, const std::string &funcname);
|
2010-01-23 09:19:22 +01:00
|
|
|
|
2010-01-16 08:47:46 +01:00
|
|
|
void getErrorMessages()
|
|
|
|
{
|
|
|
|
noConstructorError(0, "classname", false);
|
2010-05-16 14:43:42 +02:00
|
|
|
uninitVarError(0, "classname", "varname");
|
2010-01-16 08:47:46 +01:00
|
|
|
operatorEqVarError(0, "classname", "");
|
|
|
|
unusedPrivateFunctionError(0, "classname", "funcname");
|
|
|
|
memsetClassError(0, "memfunc");
|
|
|
|
memsetStructError(0, "memfunc", "classname");
|
|
|
|
operatorEqReturnError(0);
|
|
|
|
virtualDestructorError(0, "Base", "Derived");
|
|
|
|
thisSubtractionError(0);
|
|
|
|
operatorEqRetRefThisError(0);
|
|
|
|
operatorEqToSelfError(0);
|
2010-01-23 09:19:22 +01:00
|
|
|
checkConstError(0, "class", "function");
|
2010-01-16 08:47:46 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
std::string name() const
|
|
|
|
{
|
|
|
|
return "Class";
|
|
|
|
}
|
|
|
|
|
|
|
|
std::string classInfo() const
|
|
|
|
{
|
|
|
|
return "Check the code for each class.\n"
|
2010-01-17 14:56:56 +01:00
|
|
|
"* Missing constructors\n"
|
|
|
|
"* Are all variables initialized by the constructors?\n"
|
|
|
|
"* [[CheckMemset|Warn if memset, memcpy etc are used on a class]]\n"
|
|
|
|
"* If it's a base class, check that the destructor is virtual\n"
|
2010-01-23 09:19:22 +01:00
|
|
|
"* Are there unused private functions\n"
|
2010-01-27 19:25:48 +01:00
|
|
|
"* 'operator=' should return reference to self\n"
|
|
|
|
"* 'operator=' should check for assignment to self\n"
|
2010-01-23 09:19:22 +01:00
|
|
|
"* Constness for member functions\n";
|
2010-01-16 08:47:46 +01:00
|
|
|
}
|
|
|
|
};
|
|
|
|
/// @}
|
|
|
|
//---------------------------------------------------------------------------
|
|
|
|
#endif
|
|
|
|
|