|
|
/* /////////////////////////////////////////////////////////////////////////
* 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 //////////////////////////// */
|