mirror of
https://github.com/capstone-engine/llvm-capstone.git
synced 2025-04-17 13:51:21 +00:00

The debug mode has been broken pretty much ever since it was shipped because it was possible to enable the debug mode in user code without actually enabling it in the dylib, leading to ODR violations that caused various kinds of failures. This commit makes the debug mode a knob that is configured when building the library and which can't be changed afterwards. This is less flexible for users, however it will actually work as intended and it will allow us, in the future, to add various kinds of checks that do not assume the same ABI as the normal library. Furthermore, this will make the debug mode more robust, which means that vendors might be more tempted to support it properly, which hasn't been the case with the current debug mode. This patch shouldn't break any user code, except folks who are building against a library that doesn't have the debug mode enabled and who try to enable the debug mode in their code. Such users will get a compile-time error explaining that this configuration isn't supported anymore. In the future, we should further increase the granularity of the debug mode checks so that we can cherry-pick which checks to enable, like we do for unspecified behavior randomization. Differential Revision: https://reviews.llvm.org/D122941
85 lines
2.7 KiB
C++
85 lines
2.7 KiB
C++
//===----------------------------------------------------------------------===//
|
|
//
|
|
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
|
|
// See https://llvm.org/LICENSE.txt for license information.
|
|
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
#ifndef _LIBCPP___ALGORITHM_UNWRAP_ITER_H
|
|
#define _LIBCPP___ALGORITHM_UNWRAP_ITER_H
|
|
|
|
#include <__config>
|
|
#include <__memory/pointer_traits.h>
|
|
#include <iterator>
|
|
#include <type_traits>
|
|
|
|
#if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
|
|
# pragma GCC system_header
|
|
#endif
|
|
|
|
_LIBCPP_BEGIN_NAMESPACE_STD
|
|
|
|
// The job of __unwrap_iter is to lower contiguous iterators (such as
|
|
// vector<T>::iterator) into pointers, to reduce the number of template
|
|
// instantiations and to enable pointer-based optimizations e.g. in std::copy.
|
|
// For iterators that are not contiguous, it must be a no-op.
|
|
// In debug mode, we don't do this.
|
|
//
|
|
// __unwrap_iter is non-constexpr for user-defined iterators whose
|
|
// `to_address` and/or `operator->` is non-constexpr. This is okay; but we
|
|
// try to avoid doing __unwrap_iter in constant-evaluated contexts anyway.
|
|
//
|
|
// Some algorithms (e.g. std::copy, but not std::sort) need to convert an
|
|
// "unwrapped" result back into a contiguous iterator. Since contiguous iterators
|
|
// are random-access, we can do this portably using iterator arithmetic; this
|
|
// is the job of __rewrap_iter.
|
|
|
|
template <class _Iter, bool = __is_cpp17_contiguous_iterator<_Iter>::value>
|
|
struct __unwrap_iter_impl {
|
|
static _LIBCPP_CONSTEXPR _Iter
|
|
__apply(_Iter __i) _NOEXCEPT {
|
|
return __i;
|
|
}
|
|
};
|
|
|
|
#ifndef _LIBCPP_ENABLE_DEBUG_MODE
|
|
|
|
template <class _Iter>
|
|
struct __unwrap_iter_impl<_Iter, true> {
|
|
static _LIBCPP_CONSTEXPR decltype(_VSTD::__to_address(declval<_Iter>()))
|
|
__apply(_Iter __i) _NOEXCEPT {
|
|
return _VSTD::__to_address(__i);
|
|
}
|
|
};
|
|
|
|
#endif // !_LIBCPP_ENABLE_DEBUG_MODE
|
|
|
|
template<class _Iter, class _Impl = __unwrap_iter_impl<_Iter> >
|
|
inline _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR
|
|
decltype(_Impl::__apply(declval<_Iter>()))
|
|
__unwrap_iter(_Iter __i) _NOEXCEPT
|
|
{
|
|
return _Impl::__apply(__i);
|
|
}
|
|
|
|
template<class _OrigIter>
|
|
_LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR
|
|
_OrigIter __rewrap_iter(_OrigIter, _OrigIter __result)
|
|
{
|
|
return __result;
|
|
}
|
|
|
|
template<class _OrigIter, class _UnwrappedIter>
|
|
_LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR
|
|
_OrigIter __rewrap_iter(_OrigIter __first, _UnwrappedIter __result)
|
|
{
|
|
// Precondition: __result is reachable from __first
|
|
// Precondition: _OrigIter is a contiguous iterator
|
|
return __first + (__result - _VSTD::__unwrap_iter(__first));
|
|
}
|
|
|
|
_LIBCPP_END_NAMESPACE_STD
|
|
|
|
#endif // _LIBCPP___ALGORITHM_UNWRAP_ITER_H
|