ceph/src/boost/libs/range/doc/portability.qbk

   1 [/
   2     Copyright 2010 Neil Groves
   3     Distributed under the Boost Software License, Version 1.0.
   4     (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
   5 /]
   6 [section:portability Portability]
   7
   8 A huge effort has been made to port the library to as many compilers as possible.
   9
  10 Full support for built-in arrays require that the compiler supports class template partial specialization. For non-conforming compilers there might be a chance that it works anyway thanks to workarounds in the type traits library.
  11 Visual C++ 6/7.0 has a limited support for arrays: as long as the arrays are of built-in type it should work.
  12
  13 Notice also that some compilers cannot do function template ordering properly. In that case one must rely of __range_iterator__ and a single function definition instead of overloaded versions for const and non-const arguments. So if one cares about old compilers, one should not pass rvalues to the functions.
  14
  15 For maximum portability you should follow these guidelines:
  16
  17 # do not use built-in arrays,
  18 # do not pass rvalues to __begin__`()`, __end__`()` and __iterator_range__ Range constructors and assignment operators,
  19 # use __const_begin__`()` and __const_end__`()` whenever your code by intention is read-only; this will also solve most rvalue problems,
  20 # do not rely on ADL:
  21   * if you overload functions, include that header before the headers in this library,
  22   * put all overloads in namespace boost.
  23
  24
  25
  26 [endsect]
  27