2016-08-01 05:25:37 +00:00
|
|
|
/*
|
2017-02-02 10:06:28 +00:00
|
|
|
This file is part of solidity.
|
2016-08-01 05:25:37 +00:00
|
|
|
|
2017-02-02 10:06:28 +00:00
|
|
|
solidity is free software: you can redistribute it and/or modify
|
2016-08-01 05:25:37 +00:00
|
|
|
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.
|
|
|
|
|
2017-02-02 10:06:28 +00:00
|
|
|
solidity is distributed in the hope that it will be useful,
|
2016-08-01 05:25:37 +00:00
|
|
|
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
|
2017-02-02 10:06:28 +00:00
|
|
|
along with solidity. If not, see <http://www.gnu.org/licenses/>.
|
2016-08-01 05:25:37 +00:00
|
|
|
*/
|
2020-07-17 14:54:12 +00:00
|
|
|
// SPDX-License-Identifier: GPL-3.0
|
2016-08-01 05:25:37 +00:00
|
|
|
/**
|
|
|
|
* @file Assertions.h
|
|
|
|
* @author Christian <c@ethdev.com>
|
|
|
|
* @date 2015
|
|
|
|
*
|
|
|
|
* Assertion handling.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#pragma once
|
|
|
|
|
2020-01-06 10:52:23 +00:00
|
|
|
#include <libsolutil/Exceptions.h>
|
2016-08-01 05:25:37 +00:00
|
|
|
|
2021-09-23 14:26:10 +00:00
|
|
|
#include <string>
|
|
|
|
|
2019-12-11 16:31:36 +00:00
|
|
|
namespace solidity::util
|
2016-08-01 05:25:37 +00:00
|
|
|
{
|
|
|
|
|
|
|
|
#if defined(_MSC_VER)
|
|
|
|
#define ETH_FUNC __FUNCSIG__
|
|
|
|
#elif defined(__GNUC__)
|
|
|
|
#define ETH_FUNC __PRETTY_FUNCTION__
|
|
|
|
#else
|
|
|
|
#define ETH_FUNC __func__
|
|
|
|
#endif
|
|
|
|
|
2021-09-23 14:26:10 +00:00
|
|
|
namespace assertions
|
|
|
|
{
|
|
|
|
|
|
|
|
inline std::string stringOrDefault(std::string _string, std::string _defaultString)
|
|
|
|
{
|
|
|
|
// NOTE: Putting this in a function rather than directly in a macro prevents the string from
|
|
|
|
// being evaluated multiple times if it's not just a literal.
|
|
|
|
return (!_string.empty() ? _string : _defaultString);
|
|
|
|
}
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
/// Base macro that can be used to implement assertion macros.
|
|
|
|
/// Throws an exception containing the given description if the condition is not met.
|
|
|
|
/// Allows you to provide the default description for the case where the user of your macro does
|
|
|
|
/// not provide any.
|
|
|
|
/// The second parameter must be an exception class (rather than an instance).
|
|
|
|
#define assertThrowWithDefaultDescription(_condition, _exceptionType, _description, _defaultDescription) \
|
2017-01-06 14:17:16 +00:00
|
|
|
do \
|
|
|
|
{ \
|
|
|
|
if (!(_condition)) \
|
2021-10-08 12:44:43 +00:00
|
|
|
solThrow( \
|
|
|
|
_exceptionType, \
|
2022-04-06 20:22:23 +00:00
|
|
|
::solidity::util::assertions::stringOrDefault((_description), (_defaultDescription)) \
|
2017-01-06 14:17:16 +00:00
|
|
|
); \
|
|
|
|
} \
|
|
|
|
while (false)
|
2016-08-01 05:25:37 +00:00
|
|
|
|
2021-09-23 14:26:10 +00:00
|
|
|
/// Assertion that throws an exception containing the given description if it is not met.
|
|
|
|
/// Use it as assertThrow(1 == 1, ExceptionType, "Mathematics is wrong.");
|
|
|
|
/// The second parameter must be an exception class (rather than an instance).
|
|
|
|
#define assertThrow(_condition, _exceptionType, _description) \
|
2022-04-06 20:22:23 +00:00
|
|
|
assertThrowWithDefaultDescription((_condition), _exceptionType, (_description), "Assertion failed")
|
2021-09-23 14:26:10 +00:00
|
|
|
|
2016-08-01 05:25:37 +00:00
|
|
|
}
|