1 // (C) Copyright David Abrahams 2001.
2 // Distributed under the Boost Software License, Version 1.0. (See
3 // accompanying file LICENSE_1_0.txt or copy at
4 // http://www.boost.org/LICENSE_1_0.txt)
6 // See http://www.boost.org for most recent version including documentation.
9 // 1 Apr 2001 Fixes for ICL; use BOOST_STATIC_CONSTANT
10 // 11 Feb 2001 Fixes for Borland (David Abrahams)
11 // 23 Jan 2001 Added test for wchar_t (David Abrahams)
12 // 23 Jan 2001 Now statically selecting a test for signed numbers to avoid
13 // warnings with fancy compilers. Added commentary and
14 // additional dumping of traits data for tested types (David
16 // 21 Jan 2001 Initial version (David Abrahams)
18 #include <boost/detail/numeric_traits.hpp>
20 #include <boost/type_traits.hpp>
21 #include <boost/static_assert.hpp>
22 #include <boost/cstdint.hpp>
23 #include <boost/utility.hpp>
24 #include <boost/lexical_cast.hpp>
29 #ifndef BOOST_NO_LIMITS
33 // =================================================================================
34 // template class complement_traits<Number> --
36 // statically computes the max and min for 1s and 2s-complement binary
37 // numbers. This helps on platforms without <limits> support. It also shows
38 // an example of a recursive template that works with MSVC!
41 template <unsigned size
> struct complement
; // forward
43 // The template complement, below, does all the real work, using "poor man's
44 // partial specialization". We need complement_traits_aux<> so that MSVC doesn't
45 // complain about undefined min/max as we're trying to recursively define them.
46 template <class Number
, unsigned size
>
47 struct complement_traits_aux
49 BOOST_STATIC_CONSTANT(Number
, max
= complement
<size
>::template traits
<Number
>::max
);
50 BOOST_STATIC_CONSTANT(Number
, min
= complement
<size
>::template traits
<Number
>::min
);
53 template <unsigned size
>
56 template <class Number
>
60 // indirection through complement_traits_aux necessary to keep MSVC happy
61 typedef complement_traits_aux
<Number
, size
- 1> prev
;
63 #if defined(__GNUC__) && __GNUC__ == 4 && __GNUC_MINOR__ == 0 && __GNUC_PATCHLEVEL__ == 2
64 // GCC 4.0.2 ICEs on these C-style casts
65 BOOST_STATIC_CONSTANT(Number
, max
=
66 Number((prev::max
) << CHAR_BIT
)
68 BOOST_STATIC_CONSTANT(Number
, min
= Number((prev::min
) << CHAR_BIT
));
70 // Avoid left shifting negative integers, use multiplication instead
71 BOOST_STATIC_CONSTANT(Number
, shift
= 1u << CHAR_BIT
);
72 BOOST_STATIC_CONSTANT(Number
, max
=
73 Number(Number(prev::max
) * shift
)
75 BOOST_STATIC_CONSTANT(Number
, min
= Number(Number(prev::min
) * shift
));
80 // Template class complement_base<> -- defines values for min and max for
81 // complement<1>, at the deepest level of recursion. Uses "poor man's partial
82 // specialization" again.
83 template <bool is_signed
> struct complement_base
;
85 template <> struct complement_base
<false>
87 template <class Number
>
90 BOOST_STATIC_CONSTANT(Number
, min
= 0);
91 BOOST_STATIC_CONSTANT(Number
, max
= UCHAR_MAX
);
95 template <> struct complement_base
<true>
97 template <class Number
>
100 BOOST_STATIC_CONSTANT(Number
, min
= SCHAR_MIN
);
101 BOOST_STATIC_CONSTANT(Number
, max
= SCHAR_MAX
);
105 // Base specialization of complement, puts an end to the recursion.
109 template <class Number
>
112 BOOST_STATIC_CONSTANT(bool, is_signed
= boost::detail::is_signed
<Number
>::value
);
113 BOOST_STATIC_CONSTANT(Number
, min
=
114 complement_base
<is_signed
>::template values
<Number
>::min
);
115 BOOST_STATIC_CONSTANT(Number
, max
=
116 complement_base
<is_signed
>::template values
<Number
>::max
);
120 // Now here's the "pretty" template you're intended to actually use.
121 // complement_traits<Number>::min, complement_traits<Number>::max are the
122 // minimum and maximum values of Number if Number is a built-in integer type.
123 template <class Number
>
124 struct complement_traits
126 BOOST_STATIC_CONSTANT(Number
, max
= (complement_traits_aux
<Number
, sizeof(Number
)>::max
));
127 BOOST_STATIC_CONSTANT(Number
, min
= (complement_traits_aux
<Number
, sizeof(Number
)>::min
));
130 // =================================================================================
132 // Support for streaming various numeric types in exactly the format I want. I
133 // needed this in addition to all the assertions so that I could see exactly
134 // what was going on.
136 // Numbers go through a 2-stage conversion process (by default, though, no real
139 template <class T
> struct stream_as
{
144 // char types first get converted to unsigned char, then to unsigned.
145 template <> struct stream_as
<char> {
146 typedef unsigned char t1
;
149 template <> struct stream_as
<unsigned char> {
150 typedef unsigned char t1
; typedef unsigned t2
;
152 template <> struct stream_as
<signed char> {
153 typedef unsigned char t1
; typedef unsigned t2
;
156 #if defined(BOOST_MSVC_STD_ITERATOR) // No intmax streaming built-in
158 // With this library implementation, __int64 and __uint64 get streamed as strings
159 template <> struct stream_as
<boost::uintmax_t> {
160 typedef std::string t1
;
161 typedef std::string t2
;
164 template <> struct stream_as
<boost::intmax_t> {
165 typedef std::string t1
;
166 typedef std::string t2
;
170 // Standard promotion process for streaming
171 template <class T
> struct promote
173 static typename stream_as
<T
>::t1
from(T x
) {
174 typedef typename stream_as
<T
>::t1 t1
;
179 #if defined(BOOST_MSVC_STD_ITERATOR) // No intmax streaming built-in
181 // On this platform, stream them as long/unsigned long if they fit.
182 // Otherwise, write a string.
183 template <> struct promote
<boost::uintmax_t> {
184 std::string
static from(const boost::uintmax_t x
) {
186 return std::string("large unsigned value");
188 return boost::lexical_cast
<std::string
>((unsigned long)x
);
191 template <> struct promote
<boost::intmax_t> {
192 std::string
static from(const boost::intmax_t x
) {
193 if (x
> boost::intmax_t(ULONG_MAX
))
194 return std::string("large positive signed value");
196 return boost::lexical_cast
<std::string
>((unsigned long)x
);
198 if (x
< boost::intmax_t(LONG_MIN
))
199 return std::string("large negative signed value");
201 return boost::lexical_cast
<std::string
>((long)x
);
206 // This is the function which converts types to the form I want to stream them in.
208 typename stream_as
<T
>::t2
stream_number(T x
)
210 return promote
<T
>::from(x
);
212 // =================================================================================
215 // Tests for built-in signed and unsigned types
218 // Tag types for selecting tests
219 struct unsigned_tag
{};
220 struct signed_tag
{};
222 // Tests for unsigned numbers. The extra default Number parameter works around
224 template <class Number
>
225 void test_aux(unsigned_tag
, Number
*)
227 typedef typename
boost::detail::numeric_traits
<Number
>::difference_type difference_type
;
228 BOOST_STATIC_ASSERT(!boost::detail::is_signed
<Number
>::value
);
230 (sizeof(Number
) < sizeof(boost::intmax_t))
231 | (boost::is_same
<difference_type
, boost::intmax_t>::value
));
233 #if defined(__GNUC__) && __GNUC__ == 4 && __GNUC_MINOR__ == 0 && __GNUC_PATCHLEVEL__ == 2
234 // GCC 4.0.2 ICEs on this C-style cases
235 BOOST_STATIC_ASSERT((complement_traits
<Number
>::max
) > Number(0));
236 BOOST_STATIC_ASSERT((complement_traits
<Number
>::min
) == Number(0));
238 // Force casting to Number here to work around the fact that it's an enum on MSVC
239 BOOST_STATIC_ASSERT(Number(complement_traits
<Number
>::max
) > Number(0));
240 BOOST_STATIC_ASSERT(Number(complement_traits
<Number
>::min
) == Number(0));
243 const Number max
= complement_traits
<Number
>::max
;
244 const Number min
= complement_traits
<Number
>::min
;
246 const Number test_max
= (sizeof(Number
) < sizeof(boost::intmax_t))
250 std::cout
<< std::hex
<< "(unsigned) min = " << stream_number(min
) << ", max = "
251 << stream_number(max
) << "..." << std::flush
;
252 std::cout
<< "difference_type = " << typeid(difference_type
).name() << "..."
255 difference_type d1
= boost::detail::numeric_distance(Number(0), test_max
);
256 difference_type d2
= boost::detail::numeric_distance(test_max
, Number(0));
258 std::cout
<< "0->" << stream_number(test_max
) << "==" << std::dec
<< stream_number(d1
) << "; "
259 << std::hex
<< stream_number(test_max
) << "->0==" << std::dec
<< stream_number(d2
) << "..." << std::flush
;
261 assert(d1
== difference_type(test_max
));
262 assert(d2
== -difference_type(test_max
));
265 // Tests for signed numbers. The extra default Number parameter works around an
267 struct out_of_range_tag
{};
268 struct in_range_tag
{};
270 // This test morsel gets executed for numbers whose difference will always be
271 // representable in intmax_t
272 template <class Number
>
273 void signed_test(in_range_tag
, Number
*)
275 BOOST_STATIC_ASSERT(boost::detail::is_signed
<Number
>::value
);
276 typedef typename
boost::detail::numeric_traits
<Number
>::difference_type difference_type
;
277 const Number max
= complement_traits
<Number
>::max
;
278 const Number min
= complement_traits
<Number
>::min
;
280 difference_type d1
= boost::detail::numeric_distance(min
, max
);
281 difference_type d2
= boost::detail::numeric_distance(max
, min
);
283 std::cout
<< stream_number(min
) << "->" << stream_number(max
) << "==";
284 std::cout
<< std::dec
<< stream_number(d1
) << "; ";
285 std::cout
<< std::hex
<< stream_number(max
) << "->" << stream_number(min
)
286 << "==" << std::dec
<< stream_number(d2
) << "..." << std::flush
;
287 assert(d1
== difference_type(max
) - difference_type(min
));
288 assert(d2
== difference_type(min
) - difference_type(max
));
291 // This test morsel gets executed for numbers whose difference may exceed the
292 // capacity of intmax_t.
293 template <class Number
>
294 void signed_test(out_of_range_tag
, Number
*)
296 BOOST_STATIC_ASSERT(boost::detail::is_signed
<Number
>::value
);
297 typedef typename
boost::detail::numeric_traits
<Number
>::difference_type difference_type
;
298 const Number max
= complement_traits
<Number
>::max
;
299 const Number min
= complement_traits
<Number
>::min
;
301 difference_type min_distance
= complement_traits
<difference_type
>::min
;
302 difference_type max_distance
= complement_traits
<difference_type
>::max
;
304 const Number n1
= Number(min
+ max_distance
);
305 const Number n2
= Number(max
+ min_distance
);
306 difference_type d1
= boost::detail::numeric_distance(min
, n1
);
307 difference_type d2
= boost::detail::numeric_distance(max
, n2
);
309 std::cout
<< stream_number(min
) << "->" << stream_number(n1
) << "==";
310 std::cout
<< std::dec
<< stream_number(d1
) << "; ";
311 std::cout
<< std::hex
<< stream_number(max
) << "->" << stream_number(n2
)
312 << "==" << std::dec
<< stream_number(d2
) << "..." << std::flush
;
313 assert(d1
== max_distance
);
314 assert(d2
== min_distance
);
317 template <class Number
>
318 void test_aux(signed_tag
, Number
*)
320 typedef typename
boost::detail::numeric_traits
<Number
>::difference_type difference_type
;
321 BOOST_STATIC_ASSERT(boost::detail::is_signed
<Number
>::value
);
323 (sizeof(Number
) < sizeof(boost::intmax_t))
324 | (boost::is_same
<difference_type
, Number
>::value
));
326 #if defined(__GNUC__) && __GNUC__ == 4 && __GNUC_MINOR__ == 0 && __GNUC_PATCHLEVEL__ == 2
327 // GCC 4.0.2 ICEs on this cast
328 BOOST_STATIC_ASSERT((complement_traits
<Number
>::max
) > Number(0));
329 BOOST_STATIC_ASSERT((complement_traits
<Number
>::min
) < Number(0));
331 // Force casting to Number here to work around the fact that it's an enum on MSVC
332 BOOST_STATIC_ASSERT(Number(complement_traits
<Number
>::max
) > Number(0));
333 BOOST_STATIC_ASSERT(Number(complement_traits
<Number
>::min
) < Number(0));
335 const Number max
= complement_traits
<Number
>::max
;
336 const Number min
= complement_traits
<Number
>::min
;
338 std::cout
<< std::hex
<< "min = " << stream_number(min
) << ", max = "
339 << stream_number(max
) << "..." << std::flush
;
340 std::cout
<< "difference_type = " << typeid(difference_type
).name() << "..."
343 typedef typename
boost::detail::if_true
<
344 (sizeof(Number
) < sizeof(boost::intmax_t))>
350 signed_test
<Number
>(range_tag(), 0);
354 // Test for all numbers. The extra default Number parameter works around an MSVC
356 template <class Number
>
357 void test(Number
* = 0)
359 std::cout
<< "testing " << typeid(Number
).name() << ":\n"
360 #ifndef BOOST_NO_LIMITS_COMPILE_TIME_CONSTANTS
361 << "is_signed: " << (std::numeric_limits
<Number
>::is_signed
? "true\n" : "false\n")
362 << "is_bounded: " << (std::numeric_limits
<Number
>::is_bounded
? "true\n" : "false\n")
363 << "digits: " << std::numeric_limits
<Number
>::digits
<< "\n"
365 << "..." << std::flush
;
367 // factoring out difference_type for the assert below confused Borland :(
368 typedef boost::detail::is_signed
<
369 #if !defined(BOOST_MSVC) || BOOST_MSVC > 1300
372 boost::detail::numeric_traits
<Number
>::difference_type
374 BOOST_STATIC_ASSERT(is_signed::value
);
376 typedef typename
boost::detail::if_true
<
377 boost::detail::is_signed
<Number
>::value
378 >::template then
<signed_tag
, unsigned_tag
>::type signedness
;
380 test_aux
<Number
>(signedness(), 0);
381 std::cout
<< "passed" << std::endl
;
387 test
<unsigned char>();
391 test
<unsigned short>();
393 test
<unsigned int>();
395 test
<unsigned long>();
396 #if defined(BOOST_HAS_LONG_LONG) && !defined(BOOST_NO_INTEGRAL_INT64_T)
397 test
< ::boost::long_long_type
>();
398 test
< ::boost::ulong_long_type
>();
399 #elif defined(BOOST_MSVC)
400 // The problem of not having compile-time static class constants other than
401 // enums prevents this from working, since values get truncated.
402 // test<boost::uintmax_t>();
403 // test<boost::intmax_t>();