You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
272 lines
9.8 KiB
272 lines
9.8 KiB
/* /////////////////////////////////////////////////////////////////////////
|
|
* File: rangelib/rangelib.hpp
|
|
*
|
|
* Purpose: Root header for the STLSoft implementation of RangeLib.
|
|
*
|
|
* Created: 12th October 2004
|
|
* Updated: 2nd March 2012
|
|
*
|
|
* Home: http://stlsoft.org/
|
|
*
|
|
* Copyright (c) 2004-2012, Matthew Wilson and Synesis Software
|
|
* All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions are met:
|
|
*
|
|
* - Redistributions of source code must retain the above copyright notice, this
|
|
* list of conditions and the following disclaimer.
|
|
* - Redistributions in binary form must reproduce the above copyright notice,
|
|
* this list of conditions and the following disclaimer in the documentation
|
|
* and/or other materials provided with the distribution.
|
|
* - Neither the name(s) of Matthew Wilson and Synesis Software nor the names of
|
|
* any contributors may be used to endorse or promote products derived from
|
|
* this software without specific prior written permission.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
|
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
* ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
|
|
* LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
|
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
|
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
|
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
|
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
|
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
* POSSIBILITY OF SUCH DAMAGE.
|
|
*
|
|
* ////////////////////////////////////////////////////////////////////// */
|
|
|
|
|
|
#ifndef RANGELIB_INCL_RANGELIB_HPP_RANGELIB
|
|
#define RANGELIB_INCL_RANGELIB_HPP_RANGELIB
|
|
|
|
#ifndef STLSOFT_DOCUMENTATION_SKIP_SECTION
|
|
# define RANGELIB_VER_RANGELIB_HPP_RANGELIB_MAJOR 1
|
|
# define RANGELIB_VER_RANGELIB_HPP_RANGELIB_MINOR 4
|
|
# define RANGELIB_VER_RANGELIB_HPP_RANGELIB_REVISION 1
|
|
# define RANGELIB_VER_RANGELIB_HPP_RANGELIB_EDIT 29
|
|
#endif /* !STLSOFT_DOCUMENTATION_SKIP_SECTION */
|
|
|
|
/** \file rangelib/rangelib.hpp
|
|
*
|
|
* \brief [C++ only] The root header for the \ref group__project__rangelib "RangeLib" project.
|
|
*/
|
|
|
|
/* /////////////////////////////////////////////////////////////////////////
|
|
* RangeLib version
|
|
*
|
|
* The libraries version information is comprised of major, minor and revision
|
|
* components.
|
|
*
|
|
* The major version is denoted by the _RANGELIB_VER_MAJOR preprocessor symbol.
|
|
* A changes to the major version component implies that a dramatic change has
|
|
* occurred in the libraries, such that considerable changes to source dependent
|
|
* on previous versions would need to be effected.
|
|
*
|
|
* The minor version is denoted by the _RANGELIB_VER_MINOR preprocessor symbol.
|
|
* Changes to the minor version component imply that a significant change has
|
|
* occurred to the libraries, either in the addition of new functionality or in
|
|
* the destructive change to one or more components such that recomplilation and
|
|
* code change may be necessitated.
|
|
*
|
|
* The revision version is denoted by the _RANGELIB_VER_REVISION preprocessor
|
|
* symbol. Changes to the revision version component imply that a bug has been
|
|
* fixed. Dependent code should be recompiled in order to pick up the changes.
|
|
*
|
|
* In addition to the individual version symbols - _RANGELIB_VER_MAJOR,
|
|
* _RANGELIB_VER_MINOR and _RANGELIB_VER_REVISION - a composite symbol _RANGELIB_VER
|
|
* is defined, where the upper 8 bits are 0, bits 16-23 represent the major
|
|
* component, bits 8-15 represent the minor component, and bits 0-7 represent
|
|
* the revision component.
|
|
*
|
|
* Each release of the libraries will bear a different version, and that version
|
|
* will also have its own symbol: Version 1.0.1 specifies _RANGELIB_VER_1_0_1.
|
|
*
|
|
* Thus the symbol _RANGELIB_VER may be compared meaningfully with a specific
|
|
* version symbol, e.g. #if _RANGELIB_VER >= _RANGELIB_VER_1_0_1
|
|
*/
|
|
|
|
/** \brief \def _RANGELIB_VER_MAJOR
|
|
* The major version number of RangeLib
|
|
*
|
|
* \ingroup group__library__rangelib
|
|
*/
|
|
|
|
/** \brief \def _RANGELIB_VER_MINOR
|
|
* The minor version number of RangeLib
|
|
*
|
|
* \ingroup group__library__rangelib
|
|
*/
|
|
|
|
/** \brief \def _RANGELIB_VER_REVISION
|
|
* The revision version number of RangeLib
|
|
*
|
|
* \ingroup group__library__rangelib
|
|
*/
|
|
|
|
/** \brief \def _RANGELIB_VER
|
|
* The current composite version number of RangeLib
|
|
*
|
|
* \ingroup group__library__rangelib
|
|
*/
|
|
|
|
#ifndef STLSOFT_DOCUMENTATION_SKIP_SECTION
|
|
# define _RANGELIB_VER_1_0_1 0x00010001 /*!< Version 1.0.1 */
|
|
# define _RANGELIB_VER_1_0_2 0x00010002 /*!< Version 1.0.2 */
|
|
# define _RANGELIB_VER_1_0_3 0x00010003 /*!< Version 1.0.3 */
|
|
# define _RANGELIB_VER_1_0_4 0x00010004 /*!< Version 1.0.4 */
|
|
# define _RANGELIB_VER_1_1_1 0x00010101 /*!< Version 1.1.1 (with STLSoft 1.9.1) */
|
|
# define _RANGELIB_VER_1_1_2 0x00010102 /*!< Version 1.1.2 (with STLSoft 1.9.25) */
|
|
# define _RANGELIB_VER_1_1_3 0x010103ff /*!< Version 1.1.3 (with STLSoft 1.9.113) */
|
|
#endif /* !STLSOFT_DOCUMENTATION_SKIP_SECTION */
|
|
|
|
#define _RANGELIB_VER_MAJOR 1
|
|
#define _RANGELIB_VER_MINOR 1
|
|
#define _RANGELIB_VER_REVISION 3
|
|
#define _RANGELIB_VER _RANGELIB_VER_1_1_3
|
|
|
|
/* /////////////////////////////////////////////////////////////////////////
|
|
* Auto-generation and compatibility
|
|
*/
|
|
|
|
/*
|
|
[Incompatibilies-start]
|
|
STLSOFT_COMPILER_IS_MSVC: _MSC_VER < 1200
|
|
[Incompatibilies-end]
|
|
*/
|
|
|
|
/* /////////////////////////////////////////////////////////////////////////
|
|
* Includes
|
|
*/
|
|
|
|
#ifndef STLSOFT_INCL_STLSOFT_H_STLSOFT
|
|
# include <stlsoft/stlsoft.h>
|
|
#endif /* !STLSOFT_INCL_STLSOFT_H_STLSOFT */
|
|
|
|
/* /////////////////////////////////////////////////////////////////////////
|
|
* STLSoft version compatibility
|
|
*/
|
|
|
|
#if !defined(_STLSOFT_VER) || \
|
|
_STLSOFT_VER < 0x010971ff
|
|
# error RangeLib is only compatible with STLSoft version 1.9.113, or later
|
|
#endif /* _STLSOFT_VER */
|
|
|
|
/* /////////////////////////////////////////////////////////////////////////
|
|
* Compiler compatibility
|
|
*
|
|
* Currently the only compilers supported by the RangeLib libraries are
|
|
*
|
|
* Borland C++ 5.6+
|
|
* Comeau 4.3.3+
|
|
* Digital Mars C/C++ 8.42+
|
|
* Metrowerks 3.0+ (CodeWarrior 8.0+)
|
|
* Intel C/C++ 8.0+
|
|
* Visual C++ 6.0+
|
|
*/
|
|
|
|
#if defined(STLSOFT_COMPILER_IS_BORLAND)
|
|
/* Borland C++ */
|
|
# if __BORLANDC__ < 0x0560
|
|
# error Versions of Borland C++ prior to 5.6 are not supported by the RangeLib libraries
|
|
# elif __BORLANDC__ <= 0x0564
|
|
# if defined(STLSOFT_COMPILE_VERBOSE)
|
|
# pragma message("RangeLib is only partially supported on Borland C/C++ versions 5.6 and 5.6.4")
|
|
# endif /* STLSOFT_COMPILE_VERBOSE */
|
|
# endif /* __BORLANDC__ */
|
|
|
|
#elif defined(STLSOFT_COMPILER_IS_COMO)
|
|
/* Comeau C++ */
|
|
# if __COMO_VERSION__ < 4303
|
|
# error Versions of Comeau C++ prior to 4.3.3 are not supported by the RangeLib libraries
|
|
# endif /* __DMC__ */
|
|
|
|
#elif defined(STLSOFT_COMPILER_IS_DMC)
|
|
/* Digital Mars C/C++ */
|
|
# if __DMC__ < 0x0842
|
|
# error Versions of Digital Mars C/C++ prior to 8.42 are not supported by the RangeLib libraries
|
|
# endif /* __DMC__ */
|
|
|
|
#elif defined(STLSOFT_COMPILER_IS_GCC)
|
|
/* Digital Mars C/C++ */
|
|
# if __GNUC__ < 3 || \
|
|
( __GNUC__ == 3 && \
|
|
__GNUC_MINOR__ < 2)
|
|
# error Versions of GCC prior to 3.2 are not supported by the RangeLib libraries
|
|
# endif /* __DMC__ */
|
|
|
|
#elif defined(STLSOFT_COMPILER_IS_INTEL)
|
|
/* Intel C++ */
|
|
# if (__INTEL_COMPILER < 700)
|
|
# error Versions of Intel C++ prior to 7.0 are not supported by the RangeLib libraries
|
|
# endif /* __INTEL_COMPILER */
|
|
|
|
#elif defined(STLSOFT_COMPILER_IS_MWERKS)
|
|
/* Metrowerks C++ */
|
|
# if (__MWERKS__ & 0xFF00) < 0x3000
|
|
# error Versions of Metrowerks CodeWarrior C++ prior to 8.x are not supported by the RangeLib libraries
|
|
# endif /* __MWERKS__ */
|
|
|
|
#elif defined(STLSOFT_COMPILER_IS_MSVC)
|
|
/* Visual C++ */
|
|
# if _MSC_VER < 1200
|
|
# error Versions of Visual C++ prior to 5.0 are not supported by the RangeLib libraries
|
|
# elif _MSC_VER < 1310
|
|
# if defined(STLSOFT_COMPILE_VERBOSE)
|
|
# pragma message("RangeLib is only partially supported on Visual C++ versions 6.0 and 7.0")
|
|
# endif /* STLSOFT_COMPILE_VERBOSE */
|
|
# endif /* _MSC_VER */
|
|
|
|
#else /* ? compiler */
|
|
/* No recognised compiler */
|
|
# ifdef _STLSOFT_FORCE_ANY_COMPILER
|
|
# define _RANGELIB_COMPILER_IS_UNKNOWN
|
|
# ifdef STLSOFT_COMPILE_VERBOSE
|
|
# pragma message("Compiler is unknown to RangeLib")
|
|
# endif /* STLSOFT_COMPILE_VERBOSE */
|
|
# else /* ? _STLSOFT_FORCE_ANY_COMPILER */
|
|
# error Currently only Borland C++, Digital Mars C/C++, Intel C/C++, Metrowerks CodeWarrior and Visual C++ compilers are supported by the RangeLib libraries
|
|
# endif /* _STLSOFT_FORCE_ANY_COMPILER */
|
|
#endif /* compiler */
|
|
|
|
/* /////////////////////////////////////////////////////////////////////////
|
|
* Namespace
|
|
*/
|
|
|
|
#ifndef RANGELIB_NO_NAMESPACE
|
|
# if defined(_STLSOFT_NO_NAMESPACE) || \
|
|
defined(STLSOFT_DOCUMENTATION_SKIP_SECTION)
|
|
/* There is no stlsoft namespace, so must define ::rangelib */
|
|
namespace rangelib
|
|
{
|
|
# else
|
|
/* Define stlsoft::rangelib_project */
|
|
|
|
namespace stlsoft
|
|
{
|
|
|
|
namespace rangelib_project
|
|
{
|
|
|
|
# endif /* _STLSOFT_NO_NAMESPACE */
|
|
#endif /* !RANGELIB_NO_NAMESPACE */
|
|
|
|
/* ////////////////////////////////////////////////////////////////////// */
|
|
|
|
#ifndef RANGELIB_NO_NAMESPACE
|
|
# if defined(_STLSOFT_NO_NAMESPACE) || \
|
|
defined(STLSOFT_DOCUMENTATION_SKIP_SECTION)
|
|
} // namespace rangelib
|
|
# else
|
|
} // namespace rangelib_project
|
|
} // namespace stlsoft
|
|
namespace rangelib = ::stlsoft::rangelib_project;
|
|
# endif /* _STLSOFT_NO_NAMESPACE */
|
|
#endif /* !RANGELIB_NO_NAMESPACE */
|
|
|
|
/* ////////////////////////////////////////////////////////////////////// */
|
|
|
|
#endif /* !RANGELIB_INCL_RANGELIB_HPP_RANGELIB */
|
|
|
|
/* ///////////////////////////// end of file //////////////////////////// */
|