cppcheck/lib/valueflow.h

508 lines
16 KiB
C
Raw Normal View History

/*
* Cppcheck - A tool for static C/C++ code analysis
2021-03-21 20:58:32 +01:00
* Copyright (C) 2007-2021 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 valueflowH
#define valueflowH
//---------------------------------------------------------------------------
#include "astutils.h"
2017-05-27 04:33:47 +02:00
#include "config.h"
#include "mathlib.h"
#include "utils.h"
2017-05-27 04:33:47 +02:00
#include <cassert>
2020-11-10 16:00:55 +01:00
#include <functional>
#include <list>
#include <string>
2020-11-10 16:00:55 +01:00
#include <type_traits>
2017-05-27 04:33:47 +02:00
#include <utility>
#include <vector>
class ErrorLogger;
class Settings;
2017-05-27 04:33:47 +02:00
class SymbolDatabase;
class Token;
class TokenList;
class ValueType;
class Variable;
namespace ValueFlow {
2019-09-20 15:07:27 +02:00
struct increment {
2021-08-07 20:51:18 +02:00
template<class T>
2019-09-20 15:07:27 +02:00
void operator()(T& x) const {
x++;
}
};
struct decrement {
2021-08-07 20:51:18 +02:00
template<class T>
2019-09-20 15:07:27 +02:00
void operator()(T& x) const {
x--;
}
};
2020-11-10 16:00:55 +01:00
struct less {
2021-08-07 20:51:18 +02:00
template<class T, class U>
2021-04-04 18:20:32 +02:00
bool operator()(const T& x, const U& y) const {
return x < y;
}
};
struct adjacent {
2021-08-07 20:51:18 +02:00
template<class T, class U>
2021-04-04 18:20:32 +02:00
bool operator()(const T& x, const U& y) const {
return std::abs(x - y) == 1;
}
};
2020-11-10 16:00:55 +01:00
struct equalVisitor {
2021-08-07 20:51:18 +02:00
template<class T, class U>
2020-11-11 09:15:36 +01:00
void operator()(bool& result, T x, U y) const {
2020-11-10 16:00:55 +01:00
result = !(x > y || x < y);
}
};
class CPPCHECKLIB Value {
public:
typedef std::pair<const Token *, std::string> ErrorPathItem;
typedef std::list<ErrorPathItem> ErrorPath;
enum class Bound { Upper, Lower, Point };
explicit Value(long long val = 0, Bound b = Bound::Point)
2019-07-10 14:04:56 +02:00
: valueType(ValueType::INT),
bound(b),
2021-08-07 20:51:18 +02:00
intvalue(val),
tokvalue(nullptr),
floatValue(0.0),
moveKind(MoveKind::NonMovedVariable),
varvalue(val),
condition(nullptr),
varId(0U),
safe(false),
conditional(false),
defaultArg(false),
indirect(0),
path(0),
wideintvalue(val),
subexpressions(),
2021-08-07 20:51:18 +02:00
lifetimeKind(LifetimeKind::Object),
lifetimeScope(LifetimeScope::Local),
valueKind(ValueKind::Possible)
{}
Value(const Token* c, long long val, Bound b = Bound::Point);
static Value unknown();
bool equalValue(const ValueFlow::Value& rhs) const {
2016-11-13 22:33:39 +01:00
if (valueType != rhs.valueType)
return false;
switch (valueType) {
2019-07-10 14:04:56 +02:00
case ValueType::INT:
case ValueType::CONTAINER_SIZE:
case ValueType::BUFFER_SIZE:
case ValueType::ITERATOR_START:
case ValueType::ITERATOR_END:
2016-11-13 22:33:39 +01:00
if (intvalue != rhs.intvalue)
return false;
break;
2019-07-10 14:04:56 +02:00
case ValueType::TOK:
2016-11-13 22:33:39 +01:00
if (tokvalue != rhs.tokvalue)
return false;
break;
2019-07-10 14:04:56 +02:00
case ValueType::FLOAT:
2016-11-13 22:59:56 +01:00
// TODO: Write some better comparison
if (floatValue > rhs.floatValue || floatValue < rhs.floatValue)
return false;
break;
2019-07-10 14:04:56 +02:00
case ValueType::MOVED:
if (moveKind != rhs.moveKind)
return false;
break;
2019-07-10 14:04:56 +02:00
case ValueType::UNINIT:
break;
2019-07-10 14:04:56 +02:00
case ValueType::LIFETIME:
if (tokvalue != rhs.tokvalue)
return false;
break;
case ValueType::SYMBOLIC:
if (!sameToken(tokvalue, rhs.tokvalue))
return false;
if (intvalue != rhs.intvalue)
return false;
break;
}
return true;
}
2021-08-07 20:51:18 +02:00
template<class T, class F>
2020-11-11 09:15:36 +01:00
static void visitValue(T& self, F f) {
2020-11-10 16:00:55 +01:00
switch (self.valueType) {
case ValueType::INT:
case ValueType::SYMBOLIC:
case ValueType::BUFFER_SIZE:
case ValueType::CONTAINER_SIZE:
case ValueType::ITERATOR_START:
case ValueType::ITERATOR_END: {
2020-11-10 16:00:55 +01:00
f(self.intvalue);
break;
}
case ValueType::FLOAT: {
2020-11-10 16:00:55 +01:00
f(self.floatValue);
break;
}
case ValueType::UNINIT:
case ValueType::TOK:
case ValueType::LIFETIME:
case ValueType::MOVED:
break;
}
}
struct compareVisitor {
struct innerVisitor {
2021-08-07 20:51:18 +02:00
template<class Compare, class T, class U>
2021-04-04 18:20:32 +02:00
void operator()(bool& result, Compare compare, T x, U y) const {
result = compare(x, y);
}
};
2021-08-07 20:51:18 +02:00
template<class Compare, class T>
2021-04-04 18:20:32 +02:00
void operator()(bool& result, const Value& rhs, Compare compare, T x) const {
visitValue(rhs,
std::bind(innerVisitor{}, std::ref(result), std::move(compare), x, std::placeholders::_1));
}
};
2021-08-07 20:51:18 +02:00
template<class Compare>
2021-04-04 18:20:32 +02:00
bool compareValue(const Value& rhs, Compare compare) const {
assert((!this->isSymbolicValue() && !rhs.isSymbolicValue()) ||
(this->valueType == rhs.valueType && sameToken(this->tokvalue, rhs.tokvalue)));
bool result = false;
visitValue(
*this,
std::bind(compareVisitor{}, std::ref(result), std::ref(rhs), std::move(compare), std::placeholders::_1));
return result;
}
bool operator==(const Value &rhs) const {
if (!equalValue(rhs))
return false;
2016-11-13 22:33:39 +01:00
return varvalue == rhs.varvalue &&
condition == rhs.condition &&
varId == rhs.varId &&
conditional == rhs.conditional &&
defaultArg == rhs.defaultArg &&
indirect == rhs.indirect &&
valueKind == rhs.valueKind;
}
bool operator!=(const Value &rhs) const {
return !(*this == rhs);
}
2021-08-07 20:51:18 +02:00
template<class T, REQUIRES("T must be an arithmetic type", std::is_arithmetic<T> )>
2020-11-11 09:15:36 +01:00
bool equalTo(const T& x) const {
2020-11-10 16:00:55 +01:00
bool result = false;
visitValue(*this, std::bind(equalVisitor{}, std::ref(result), x, std::placeholders::_1));
return result;
}
2019-09-20 15:07:27 +02:00
void decreaseRange() {
if (bound == Bound::Lower)
2020-11-10 16:00:55 +01:00
visitValue(*this, increment{});
else if (bound == Bound::Upper)
2020-11-10 16:00:55 +01:00
visitValue(*this, decrement{});
}
void invertBound() {
if (bound == Bound::Lower)
bound = Bound::Upper;
else if (bound == Bound::Upper)
bound = Bound::Lower;
}
void invertRange() {
invertBound();
decreaseRange();
}
void assumeCondition(const Token* tok);
std::string infoString() const;
enum class ValueType {
INT,
TOK,
FLOAT,
MOVED,
UNINIT,
CONTAINER_SIZE,
LIFETIME,
BUFFER_SIZE,
ITERATOR_START,
ITERATOR_END,
SYMBOLIC
} valueType;
2016-11-13 22:33:39 +01:00
bool isIntValue() const {
2019-07-10 14:04:56 +02:00
return valueType == ValueType::INT;
2016-11-13 22:33:39 +01:00
}
bool isTokValue() const {
2019-07-10 14:04:56 +02:00
return valueType == ValueType::TOK;
2016-11-13 22:33:39 +01:00
}
2016-11-13 22:59:56 +01:00
bool isFloatValue() const {
2019-07-10 14:04:56 +02:00
return valueType == ValueType::FLOAT;
2016-11-13 22:59:56 +01:00
}
bool isMovedValue() const {
2019-07-10 14:04:56 +02:00
return valueType == ValueType::MOVED;
}
bool isUninitValue() const {
2019-07-10 14:04:56 +02:00
return valueType == ValueType::UNINIT;
}
bool isContainerSizeValue() const {
2019-07-10 14:04:56 +02:00
return valueType == ValueType::CONTAINER_SIZE;
}
bool isLifetimeValue() const {
2019-07-10 14:04:56 +02:00
return valueType == ValueType::LIFETIME;
}
bool isBufferSizeValue() const {
2019-07-10 14:04:56 +02:00
return valueType == ValueType::BUFFER_SIZE;
}
bool isIteratorValue() const {
return valueType == ValueType::ITERATOR_START || valueType == ValueType::ITERATOR_END;
}
bool isIteratorStartValue() const {
return valueType == ValueType::ITERATOR_START;
}
bool isIteratorEndValue() const {
return valueType == ValueType::ITERATOR_END;
}
2021-08-01 14:05:30 +02:00
bool isSymbolicValue() const {
return valueType == ValueType::SYMBOLIC;
}
2016-11-13 22:33:39 +01:00
2019-01-29 09:48:18 +01:00
bool isLocalLifetimeValue() const {
2019-07-16 11:12:35 +02:00
return valueType == ValueType::LIFETIME && lifetimeScope == LifetimeScope::Local;
2019-01-29 09:48:18 +01:00
}
2019-01-29 09:48:18 +01:00
bool isArgumentLifetimeValue() const {
2019-07-16 11:12:35 +02:00
return valueType == ValueType::LIFETIME && lifetimeScope == LifetimeScope::Argument;
2019-01-29 09:48:18 +01:00
}
2020-09-10 08:02:45 +02:00
bool isSubFunctionLifetimeValue() const {
2020-09-04 18:56:34 +02:00
return valueType == ValueType::LIFETIME && lifetimeScope == LifetimeScope::SubFunction;
}
bool isNonValue() const {
return isMovedValue() || isUninitValue() || isLifetimeValue();
}
/** The value bound */
Bound bound;
2021-02-23 08:19:05 +01:00
/** int value (or sometimes bool value?) */
long long intvalue;
/** token value - the token that has the value. this is used for pointer aliases, strings, etc. */
const Token *tokvalue;
2016-11-13 22:59:56 +01:00
/** float value */
double floatValue;
/** kind of moved */
2019-07-10 15:27:07 +02:00
enum class MoveKind {NonMovedVariable, MovedVariable, ForwardedVariable} moveKind;
/** For calculated values - variable value that calculated value depends on */
long long varvalue;
/** Condition that this value depends on */
2014-05-19 14:37:54 +02:00
const Token *condition;
ErrorPath errorPath;
2014-05-19 14:37:54 +02:00
/** For calculated values - varId that calculated value depends on */
nonneg int varId;
2014-05-19 14:37:54 +02:00
2019-07-25 17:19:51 +02:00
/** value relies on safe checking */
bool safe;
/** Conditional value */
bool conditional;
2015-02-01 15:23:15 +01:00
/** Is this value passed as default parameter to the function? */
bool defaultArg;
2018-11-10 21:30:01 +01:00
int indirect;
/** Path id */
MathLib::bigint path;
/** int value before implicit truncation */
long long wideintvalue;
std::vector<std::string> subexpressions;
2021-06-04 21:41:30 +02:00
enum class LifetimeKind {
// Pointer points to a member of lifetime
2021-06-05 08:53:15 +02:00
Object,
2021-06-04 21:41:30 +02:00
// A member of object points to the lifetime
2021-06-05 08:53:15 +02:00
SubObject,
// Lambda has captured lifetime(similar to SubObject)
2021-06-05 08:53:15 +02:00
Lambda,
// Iterator points to the lifetime of a container(similar to Object)
2021-06-05 08:53:15 +02:00
Iterator,
2021-06-04 21:41:30 +02:00
// A pointer that holds the address of the lifetime
Address
} lifetimeKind;
2020-09-04 18:56:34 +02:00
enum class LifetimeScope { Local, Argument, SubFunction } lifetimeScope;
static const char* toString(MoveKind moveKind);
2021-06-04 21:41:30 +02:00
static const char* toString(LifetimeKind lifetimeKind);
static const char* toString(LifetimeScope lifetimeScope);
static const char* toString(Bound bound);
/** How known is this value */
enum class ValueKind {
/** This value is possible, other unlisted values may also be possible */
Possible,
/** Only listed values are possible */
Known,
/** Inconclusive */
Inconclusive,
/** Listed values are impossible */
Impossible
} valueKind;
void setKnown() {
valueKind = ValueKind::Known;
}
bool isKnown() const {
return valueKind == ValueKind::Known;
}
void setPossible() {
valueKind = ValueKind::Possible;
}
bool isPossible() const {
return valueKind == ValueKind::Possible;
}
2019-09-20 15:07:27 +02:00
bool isImpossible() const {
return valueKind == ValueKind::Impossible;
}
2019-09-20 15:07:27 +02:00
void setImpossible() {
valueKind = ValueKind::Impossible;
}
void setInconclusive(bool inconclusive = true) {
if (inconclusive)
valueKind = ValueKind::Inconclusive;
}
bool isInconclusive() const {
return valueKind == ValueKind::Inconclusive;
}
void changeKnownToPossible() {
if (isKnown())
valueKind = ValueKind::Possible;
}
bool errorSeverity() const {
return !condition && !defaultArg;
}
static bool sameToken(const Token* tok1, const Token* tok2);
};
2016-05-07 20:18:07 +02:00
/// Constant folding of expression. This can be used before the full ValueFlow has been executed (ValueFlow::setValues).
const ValueFlow::Value * valueFlowConstantFoldAST(Token *expr, const Settings *settings);
2016-05-07 20:18:07 +02:00
/// Perform valueflow analysis.
void setValues(TokenList *tokenlist, SymbolDatabase* symboldatabase, ErrorLogger *errorLogger, const Settings *settings);
std::string eitherTheConditionIsRedundant(const Token *condition);
size_t getSizeOf(const ValueType &vt, const Settings *settings);
const ValueFlow::Value* findValue(const std::list<ValueFlow::Value>& values,
const Settings* settings,
std::function<bool(const ValueFlow::Value&)> pred);
std::vector<ValueFlow::Value> isOutOfBounds(const Value& size, const Token* indexTok, bool possible = true);
}
struct LifetimeToken {
const Token* token;
bool addressOf;
ValueFlow::Value::ErrorPath errorPath;
bool inconclusive;
LifetimeToken() : token(nullptr), addressOf(false), errorPath(), inconclusive(false) {}
LifetimeToken(const Token* token, ValueFlow::Value::ErrorPath errorPath)
: token(token), addressOf(false), errorPath(std::move(errorPath)), inconclusive(false)
{}
LifetimeToken(const Token* token, bool addressOf, ValueFlow::Value::ErrorPath errorPath)
: token(token), addressOf(addressOf), errorPath(std::move(errorPath)), inconclusive(false)
{}
static std::vector<LifetimeToken> setAddressOf(std::vector<LifetimeToken> v, bool b) {
for (LifetimeToken& x : v)
x.addressOf = b;
return v;
}
static std::vector<LifetimeToken> setInconclusive(std::vector<LifetimeToken> v, bool b) {
for (LifetimeToken& x : v)
x.inconclusive = b;
return v;
}
};
const Token *parseCompareInt(const Token *tok, ValueFlow::Value &true_value, ValueFlow::Value &false_value, const std::function<std::vector<MathLib::bigint>(const Token*)>& evaluate);
const Token *parseCompareInt(const Token *tok, ValueFlow::Value &true_value, ValueFlow::Value &false_value);
ValueFlow::Value inferCondition(std::string op, MathLib::bigint val, const Token* varTok);
ValueFlow::Value inferCondition(const std::string& op, const Token* varTok, MathLib::bigint val);
std::vector<LifetimeToken> getLifetimeTokens(const Token* tok,
2021-08-07 20:51:18 +02:00
bool escape = false,
ValueFlow::Value::ErrorPath errorPath = ValueFlow::Value::ErrorPath{});
bool hasLifetimeToken(const Token* tok, const Token* lifetime);
const Variable* getLifetimeVariable(const Token* tok, ValueFlow::Value::ErrorPath& errorPath, bool* addressOf = nullptr);
const Variable* getLifetimeVariable(const Token* tok);
bool isLifetimeBorrowed(const Token *tok, const Settings *settings);
std::string lifetimeType(const Token *tok, const ValueFlow::Value *val);
std::string lifetimeMessage(const Token *tok, const ValueFlow::Value *val, ValueFlow::Value::ErrorPath &errorPath);
CPPCHECKLIB ValueFlow::Value getLifetimeObjValue(const Token *tok, bool inconclusive = false);
CPPCHECKLIB std::vector<ValueFlow::Value> getLifetimeObjValues(const Token *tok, bool inconclusive = false, bool subfunction = false);
#endif // valueflowH