1 // boost\math\tools\promotion.hpp 2 3 // Copyright John Maddock 2006. 4 // Copyright Paul A. Bristow 2006. 5 6 // Use, modification and distribution are subject to the 7 // Boost Software License, Version 1.0. 8 // (See accompanying file LICENSE_1_0.txt 9 // or copy at http://www.boost.org/LICENSE_1_0.txt) 10 11 // Promote arguments functions to allow math functions to have arguments 12 // provided as integer OR real (floating-point, built-in or UDT) 13 // (called ArithmeticType in functions that use promotion) 14 // that help to reduce the risk of creating multiple instantiations. 15 // Allows creation of an inline wrapper that forwards to a foo(RT, RT) function, 16 // so you never get to instantiate any mixed foo(RT, IT) functions. 17 18 #ifndef BOOST_MATH_PROMOTION_HPP 19 #define BOOST_MATH_PROMOTION_HPP 20 21 #ifdef _MSC_VER 22 #pragma once 23 #endif 24 25 // Boost type traits: 26 #include <boost/math/tools/config.hpp> 27 #include <boost/type_traits/is_floating_point.hpp> // for boost::is_floating_point; 28 #include <boost/type_traits/is_integral.hpp> // for boost::is_integral 29 #include <boost/type_traits/is_convertible.hpp> // for boost::is_convertible 30 #include <boost/type_traits/is_same.hpp>// for boost::is_same 31 #include <boost/type_traits/remove_cv.hpp>// for boost::remove_cv 32 // Boost Template meta programming: 33 #include <boost/mpl/if.hpp> // for boost::mpl::if_c. 34 #include <boost/mpl/and.hpp> // for boost::mpl::if_c. 35 #include <boost/mpl/or.hpp> // for boost::mpl::if_c. 36 #include <boost/mpl/not.hpp> // for boost::mpl::if_c. 37 38 #ifdef BOOST_MATH_NO_LONG_DOUBLE_MATH_FUNCTIONS 39 #include <boost/static_assert.hpp> 40 #endif 41 42 namespace boost 43 { 44 namespace math 45 { 46 namespace tools 47 { 48 // If either T1 or T2 is an integer type, 49 // pretend it was a double (for the purposes of further analysis). 50 // Then pick the wider of the two floating-point types 51 // as the actual signature to forward to. 52 // For example: 53 // foo(int, short) -> double foo(double, double); 54 // foo(int, float) -> double foo(double, double); 55 // Note: NOT float foo(float, float) 56 // foo(int, double) -> foo(double, double); 57 // foo(double, float) -> double foo(double, double); 58 // foo(double, float) -> double foo(double, double); 59 // foo(any-int-or-float-type, long double) -> foo(long double, long double); 60 // but ONLY float foo(float, float) is unchanged. 61 // So the only way to get an entirely float version is to call foo(1.F, 2.F), 62 // But since most (all?) the math functions convert to double internally, 63 // probably there would not be the hoped-for gain by using float here. 64 65 // This follows the C-compatible conversion rules of pow, etc 66 // where pow(int, float) is converted to pow(double, double). 67 68 template <class T> 69 struct promote_arg 70 { // If T is integral type, then promote to double. 71 typedef typename mpl::if_<is_integral<T>, double, T>::type type; 72 }; 73 // These full specialisations reduce mpl::if_ usage and speed up 74 // compilation: 75 template <> struct promote_arg<float> { typedef float type; }; 76 template <> struct promote_arg<double>{ typedef double type; }; 77 template <> struct promote_arg<long double> { typedef long double type; }; 78 template <> struct promote_arg<int> { typedef double type; }; 79 80 template <class T1, class T2> 81 struct promote_args_2 82 { // Promote, if necessary, & pick the wider of the two floating-point types. 83 // for both parameter types, if integral promote to double. 84 typedef typename promote_arg<T1>::type T1P; // T1 perhaps promoted. 85 typedef typename promote_arg<T2>::type T2P; // T2 perhaps promoted. 86 87 typedef typename mpl::if_< 88 typename mpl::and_<is_floating_point<T1P>, is_floating_point<T2P> >::type, // both T1P and T2P are floating-point? 89 typename mpl::if_< typename mpl::or_<is_same<long double, T1P>, is_same<long double, T2P> >::type, // either long double? 90 long double, // then result type is long double. 91 typename mpl::if_< typename mpl::or_<is_same<double, T1P>, is_same<double, T2P> >::type, // either double? 92 double, // result type is double. 93 float // else result type is float. 94 >::type 95 >::type, 96 // else one or the other is a user-defined type: 97 typename mpl::if_< typename mpl::and_<mpl::not_<is_floating_point<T2P> >, ::boost::is_convertible<T1P, T2P> >, T2P, T1P>::type>::type type; 98 }; // promote_arg2 99 // These full specialisations reduce mpl::if_ usage and speed up 100 // compilation: 101 template <> struct promote_args_2<float, float> { typedef float type; }; 102 template <> struct promote_args_2<double, double>{ typedef double type; }; 103 template <> struct promote_args_2<long double, long double> { typedef long double type; }; 104 template <> struct promote_args_2<int, int> { typedef double type; }; 105 template <> struct promote_args_2<int, float> { typedef double type; }; 106 template <> struct promote_args_2<float, int> { typedef double type; }; 107 template <> struct promote_args_2<int, double> { typedef double type; }; 108 template <> struct promote_args_2<double, int> { typedef double type; }; 109 template <> struct promote_args_2<int, long double> { typedef long double type; }; 110 template <> struct promote_args_2<long double, int> { typedef long double type; }; 111 template <> struct promote_args_2<float, double> { typedef double type; }; 112 template <> struct promote_args_2<double, float> { typedef double type; }; 113 template <> struct promote_args_2<float, long double> { typedef long double type; }; 114 template <> struct promote_args_2<long double, float> { typedef long double type; }; 115 template <> struct promote_args_2<double, long double> { typedef long double type; }; 116 template <> struct promote_args_2<long double, double> { typedef long double type; }; 117 118 template <class T1, class T2=float, class T3=float, class T4=float, class T5=float, class T6=float> 119 struct promote_args 120 { 121 typedef typename promote_args_2< 122 typename remove_cv<T1>::type, 123 typename promote_args_2< 124 typename remove_cv<T2>::type, 125 typename promote_args_2< 126 typename remove_cv<T3>::type, 127 typename promote_args_2< 128 typename remove_cv<T4>::type, 129 typename promote_args_2< 130 typename remove_cv<T5>::type, typename remove_cv<T6>::type 131 >::type 132 >::type 133 >::type 134 >::type 135 >::type type; 136 137 #ifdef BOOST_MATH_NO_LONG_DOUBLE_MATH_FUNCTIONS 138 // 139 // Guard against use of long double if it's not supported: 140 // 141 BOOST_STATIC_ASSERT((0 == ::boost::is_same<type, long double>::value)); 142 #endif 143 }; 144 145 } // namespace tools 146 } // namespace math 147 } // namespace boost 148 149 #endif // BOOST_MATH_PROMOTION_HPP 150 151