311 lines
9.1 KiB
C++
311 lines
9.1 KiB
C++
/*
|
|
* Cppcheck - A tool for static C/C++ code analysis
|
|
* Copyright (C) 2007-2011 Daniel Marjamäki and Cppcheck team.
|
|
*
|
|
* 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 errorloggerH
|
|
#define errorloggerH
|
|
|
|
#include <list>
|
|
#include <string>
|
|
|
|
#include "settings.h"
|
|
|
|
class Token;
|
|
class Tokenizer;
|
|
|
|
/// @addtogroup Core
|
|
/// @{
|
|
|
|
/** @brief enum class for severity. Used when reporting errors. */
|
|
class Severity
|
|
{
|
|
public:
|
|
/**
|
|
* Message severities.
|
|
*/
|
|
enum SeverityType
|
|
{
|
|
/**
|
|
* No severity (default value).
|
|
*/
|
|
none,
|
|
/**
|
|
* Programming error.
|
|
* This indicates severe error like memory leak etc.
|
|
* The error is certain.
|
|
*/
|
|
error,
|
|
/**
|
|
* Warning.
|
|
* Used for dangerous coding style that can cause severe runtime errors.
|
|
* For example: forgetting to initialize a member variable in a constructor.
|
|
*/
|
|
warning,
|
|
/**
|
|
* Style warning.
|
|
* Used for general code cleanup recommendations. Fixing these
|
|
* will not fix any bugs but will make the code easier to maintain.
|
|
* For example: redundant code, unreachable code, etc.
|
|
*/
|
|
style,
|
|
/**
|
|
* Performance warning.
|
|
* Not an error as is but suboptimal code and fixing it probably leads
|
|
* to faster performance of the compiled code.
|
|
*/
|
|
performance,
|
|
/**
|
|
* Portability warning.
|
|
* This warning indicates the code is not properly portable for
|
|
* different platforms and bitnesses (32/64 bit). If the code is meant
|
|
* to compile in different platforms and bitnesses these warnings
|
|
* should be fixed.
|
|
*/
|
|
portability,
|
|
/**
|
|
* Checking information.
|
|
* Information message about the checking (process) itself. These
|
|
* messages inform about header files not found etc issues that are
|
|
* not errors in the code but something user needs to know.
|
|
*/
|
|
information,
|
|
/**
|
|
* Debug message.
|
|
* Debug-mode message useful for the developers.
|
|
*/
|
|
debug
|
|
};
|
|
|
|
static std::string toString(SeverityType severity)
|
|
{
|
|
switch (severity)
|
|
{
|
|
case none:
|
|
return "";
|
|
case error:
|
|
return "error";
|
|
case warning:
|
|
return "warning";
|
|
case style:
|
|
return "style";
|
|
case performance:
|
|
return "performance";
|
|
case portability:
|
|
return "portability";
|
|
case information:
|
|
return "information";
|
|
case debug:
|
|
return "debug";
|
|
};
|
|
return "???";
|
|
}
|
|
static SeverityType fromString(const std::string &severity)
|
|
{
|
|
if (severity.empty())
|
|
return none;
|
|
if (severity == "none")
|
|
return none;
|
|
if (severity == "error")
|
|
return error;
|
|
if (severity == "warning")
|
|
return warning;
|
|
if (severity == "style")
|
|
return style;
|
|
if (severity == "performance")
|
|
return performance;
|
|
if (severity == "portability")
|
|
return portability;
|
|
if (severity == "information")
|
|
return information;
|
|
if (severity == "debug")
|
|
return debug;
|
|
return none;
|
|
}
|
|
};
|
|
|
|
/**
|
|
* @brief This is an interface, which the class responsible of error logging
|
|
* should implement.
|
|
*/
|
|
class ErrorLogger
|
|
{
|
|
public:
|
|
|
|
/**
|
|
* Wrapper for error messages, provided by reportErr()
|
|
*/
|
|
class ErrorMessage
|
|
{
|
|
public:
|
|
/**
|
|
* File name and line number.
|
|
* Internally paths are stored with / separator. When getting the filename
|
|
* it is by default converted to native separators.
|
|
*/
|
|
class FileLocation
|
|
{
|
|
public:
|
|
FileLocation()
|
|
{
|
|
line = 0;
|
|
}
|
|
|
|
FileLocation(const std::string &file, unsigned int aline)
|
|
: line(aline), _file(file)
|
|
{
|
|
}
|
|
|
|
/**
|
|
* Return the filename.
|
|
* @param convert If true convert path to native separators.
|
|
* @return filename.
|
|
*/
|
|
std::string getfile(bool convert = true) const;
|
|
|
|
/**
|
|
* Set the filename.
|
|
* @param file Filename to set.
|
|
*/
|
|
void setfile(const std::string &file);
|
|
unsigned int line;
|
|
private:
|
|
std::string _file;
|
|
|
|
};
|
|
|
|
ErrorMessage(const std::list<FileLocation> &callStack, Severity::SeverityType severity, const std::string &msg, const std::string &id, bool inconclusive);
|
|
ErrorMessage();
|
|
|
|
/**
|
|
* Format the error message in XML format
|
|
* @param verbose use verbose message
|
|
* @param ver XML version
|
|
*/
|
|
std::string toXML(bool verbose, int ver) const;
|
|
|
|
static std::string getXMLHeader(int xml_version);
|
|
static std::string getXMLFooter(int xml_version);
|
|
|
|
/**
|
|
* Format the error message into a string.
|
|
* @param verbose use verbose message
|
|
* @param outputFormat Empty string to use default output format
|
|
* or template to be used. E.g. "{file}:{line},{severity},{id},{message}"
|
|
*/
|
|
std::string toString(bool verbose, const std::string &outputFormat = "") const;
|
|
|
|
std::string serialize() const;
|
|
bool deserialize(const std::string &data);
|
|
|
|
std::list<FileLocation> _callStack;
|
|
Severity::SeverityType _severity;
|
|
std::string _id;
|
|
bool _inconclusive;
|
|
|
|
/** source file (not header) */
|
|
std::string file0;
|
|
|
|
/** set short and verbose messages */
|
|
void setmsg(const std::string &msg);
|
|
|
|
/** Short message (single line short message) */
|
|
const std::string &shortMessage() const
|
|
{
|
|
return _shortMessage;
|
|
}
|
|
|
|
/** Verbose message (may be the same as the short message) */
|
|
const std::string &verboseMessage() const
|
|
{
|
|
return _verboseMessage;
|
|
}
|
|
|
|
private:
|
|
/**
|
|
* Replace all occurrences of searchFor with replaceWith in the
|
|
* given source.
|
|
* @param source The string to modify
|
|
* @param searchFor What should be searched for
|
|
* @param replaceWith What will replace the found item
|
|
*/
|
|
static void findAndReplace(std::string &source, const std::string &searchFor, const std::string &replaceWith);
|
|
|
|
/** Short message */
|
|
std::string _shortMessage;
|
|
|
|
/** Verbose message */
|
|
std::string _verboseMessage;
|
|
};
|
|
|
|
ErrorLogger() { }
|
|
virtual ~ErrorLogger() { }
|
|
|
|
/**
|
|
* Information about progress is directed here.
|
|
* Override this to receive the progress messages.
|
|
*
|
|
* @param outmsg Message to show e.g. "Checking main.cpp..."
|
|
*/
|
|
virtual void reportOut(const std::string &outmsg) = 0;
|
|
|
|
/**
|
|
* Information about found errors and warnings is directed
|
|
* here. Override this to receive the errormessages.
|
|
*
|
|
* @param msg Location and other information about the found.
|
|
* error
|
|
*/
|
|
virtual void reportErr(const ErrorLogger::ErrorMessage &msg) = 0;
|
|
|
|
/**
|
|
* Information about how many files have been checked
|
|
*
|
|
* @param fileindex This many files have been checked.
|
|
* @param filecount This many files there are in total.
|
|
* @param sizedone The sum of sizes of the files checked.
|
|
* @param sizetotal The total sizes of the files.
|
|
*/
|
|
virtual void reportStatus(unsigned int fileindex, unsigned int filecount, long sizedone, long sizetotal) = 0;
|
|
|
|
/**
|
|
* Report progress to client
|
|
* @param filename main file that is checked
|
|
* @param stage for example preprocess / tokenize / simplify / check
|
|
* @param value progress value (0-100)
|
|
*/
|
|
virtual void reportProgress(const std::string &filename, const char stage[], const unsigned int value)
|
|
{
|
|
(void)filename;
|
|
(void)stage;
|
|
(void)value;
|
|
}
|
|
|
|
/**
|
|
* Report list of unmatched suppressions
|
|
* @param unmatched list of unmatched suppressions (from Settings::Suppressions::getUnmatched(Local|Global)Suppressions)
|
|
*/
|
|
void reportUnmatchedSuppressions(const std::list<Settings::Suppressions::SuppressionEntry> &unmatched);
|
|
|
|
static std::string callStackToString(const std::list<ErrorLogger::ErrorMessage::FileLocation> &callStack);
|
|
};
|
|
|
|
|
|
/// @}
|
|
|
|
#endif
|