---

stlsoft_limit_traits.h

Go to the documentation of this file.

/* 
 * File:        stlsoft_limit_traits.h
 *
 * Purpose:     limit_traits classes. Provides nothing that is not in
 *              std::numeric_limits, but uses minimum() and maximum() rather
 *              than min() and max(), since some compilers are not well-behaved
 *              in making these functions rather than macros.
 *
 * Created:     16th January 2002
 * Updated:     11th September 2004
 *
 * Home:        http://stlsoft.org/
 *
 * Copyright (c) 2002-2004, 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 STLSOFT_INCL_H_STLSOFT_LIMIT_TRAITS
#define STLSOFT_INCL_H_STLSOFT_LIMIT_TRAITS

#ifndef __STLSOFT_DOCUMENTATION_SKIP_SECTION
# define STLSOFT_VER_H_STLSOFT_LIMIT_TRAITS_MAJOR        2
# define STLSOFT_VER_H_STLSOFT_LIMIT_TRAITS_MINOR        0
# define STLSOFT_VER_H_STLSOFT_LIMIT_TRAITS_REVISION     1
# define STLSOFT_VER_H_STLSOFT_LIMIT_TRAITS_EDIT         30
#endif /* !__STLSOFT_DOCUMENTATION_SKIP_SECTION */

/* 
 * Includes
 */

#ifndef STLSOFT_INCL_H_STLSOFT
# include "stlsoft.h"   // Include the STLSoft root header
#endif /* !STLSOFT_INCL_H_STLSOFT */

/* 
 * Namespace
 */

#ifndef _STLSOFT_NO_NAMESPACE
namespace stlsoft
{
#endif /* _STLSOFT_NO_NAMESPACE */

/* 
 * Constants & definitions
 */

#ifndef __STLSOFT_DOCUMENTATION_SKIP_SECTION

#define __STLSOFT_GEN_SINT8_SUFFIX(i)           (i)
#define __STLSOFT_GEN_UINT8_SUFFIX(i)           (i ## U)
#define __STLSOFT_GEN_SINT16_SUFFIX(i)          (i)
#define __STLSOFT_GEN_UINT16_SUFFIX(i)          (i ## U)
#define __STLSOFT_GEN_SINT32_SUFFIX(i)          (i ## L)
#define __STLSOFT_GEN_UINT32_SUFFIX(i)          (i ## UL)
#if (   defined(__STLSOFT_COMPILER_IS_DMC) || \
        defined(__STLSOFT_COMPILER_IS_COMO) || \
        defined(__STLSOFT_COMPILER_IS_GCC) || \
        defined(__STLSOFT_COMPILER_IS_MWERKS))
# define __STLSOFT_GEN_SINT64_SUFFIX(i)         (i ## LL)
# define __STLSOFT_GEN_UINT64_SUFFIX(i)         (i ## ULL)
#elif ( defined(__STLSOFT_COMPILER_IS_BORLAND) || \
        defined(__STLSOFT_COMPILER_IS_INTEL) || \
        defined(__STLSOFT_COMPILER_IS_MSVC) || \
        defined(__STLSOFT_COMPILER_IS_VECTORC) || \
        defined(__STLSOFT_COMPILER_IS_WATCOM))
# define __STLSOFT_GEN_SINT64_SUFFIX(i)         (i ## L)
# define __STLSOFT_GEN_UINT64_SUFFIX(i)         (i ## UL)
#else
#error Compiler not discriminated
#endif /* __STLSOFT_DVS_COMPILER_GNUC || __STLSOFT_DVS_COMPILER_DECCXX */


#define __STLSOFT_LIMIT_TRAITS__SINT8_MIN       (- __STLSOFT_GEN_SINT8_SUFFIX(127) - 1)
#define __STLSOFT_LIMIT_TRAITS__SINT8_MAX       (+ __STLSOFT_GEN_SINT8_SUFFIX(127))

#define __STLSOFT_LIMIT_TRAITS__UINT8_MIN       (  __STLSOFT_GEN_UINT8_SUFFIX(0))
#define __STLSOFT_LIMIT_TRAITS__UINT8_MAX       (  __STLSOFT_GEN_UINT8_SUFFIX(255))


#define __STLSOFT_LIMIT_TRAITS__SINT16_MIN      (- __STLSOFT_GEN_SINT16_SUFFIX(32767) - 1)
#define __STLSOFT_LIMIT_TRAITS__SINT16_MAX      (+ __STLSOFT_GEN_SINT16_SUFFIX(32767))

#define __STLSOFT_LIMIT_TRAITS__UINT16_MIN      (  __STLSOFT_GEN_UINT16_SUFFIX(0))
#define __STLSOFT_LIMIT_TRAITS__UINT16_MAX      (  __STLSOFT_GEN_UINT16_SUFFIX(65535))


#define __STLSOFT_LIMIT_TRAITS__SINT32_MIN      (- __STLSOFT_GEN_SINT32_SUFFIX(2147483647) - 1)
#define __STLSOFT_LIMIT_TRAITS__SINT32_MAX      (+ __STLSOFT_GEN_SINT32_SUFFIX(2147483647))

#define __STLSOFT_LIMIT_TRAITS__UINT32_MIN      (  __STLSOFT_GEN_UINT32_SUFFIX(0))
#define __STLSOFT_LIMIT_TRAITS__UINT32_MAX      (  __STLSOFT_GEN_UINT32_SUFFIX(4294967295))


#define __STLSOFT_LIMIT_TRAITS__SINT64_MIN      (- __STLSOFT_GEN_SINT64_SUFFIX(9223372036854775807) - 1)
#define __STLSOFT_LIMIT_TRAITS__SINT64_MAX      (+ __STLSOFT_GEN_SINT64_SUFFIX(9223372036854775807) )

#define __STLSOFT_LIMIT_TRAITS__UINT64_MIN      (  __STLSOFT_GEN_UINT64_SUFFIX(0) )
#define __STLSOFT_LIMIT_TRAITS__UINT64_MAX      (  __STLSOFT_GEN_UINT64_SUFFIX(18446744073709551615) )

#endif /* !__STLSOFT_DOCUMENTATION_SKIP_SECTION */

/* 
 * Classes
 */

#ifdef __STLSOFT_DOCUMENTATION_SKIP_SECTION
template <ss_typename_param_k T>
struct limit_traits
{
public:
    typedef T value_type;

public:
    static value_type       minimum();
    static value_type       maximum();

#ifdef STLSOFT_CF_MEMBER_CONSTANT_SUPPORT
    static const value_type minimum_value = ???;
    static const value_type maximum_value = ???;
#endif /* STLSOFT_CF_MEMBER_CONSTANT_SUPPORT */
};

#else

// class limit_traits

template <ss_typename_param_k T>
struct limit_traits;

/* s/uint8 */
STLSOFT_TEMPLATE_SPECIALISATION
struct limit_traits<ss_sint8_t>
{
public:
    typedef ss_sint8_t  value_type;

public:
    static value_type       minimum() { return __STLSOFT_LIMIT_TRAITS__SINT8_MIN; }
    static value_type       maximum() { return __STLSOFT_LIMIT_TRAITS__SINT8_MAX; }

#ifdef STLSOFT_CF_MEMBER_CONSTANT_SUPPORT
    static const value_type minimum_value = __STLSOFT_LIMIT_TRAITS__SINT8_MIN;
    static const value_type maximum_value = __STLSOFT_LIMIT_TRAITS__SINT8_MAX;
#endif /* STLSOFT_CF_MEMBER_CONSTANT_SUPPORT */
};

STLSOFT_TEMPLATE_SPECIALISATION
struct limit_traits<ss_uint8_t>
{
public:
    typedef ss_uint8_t  value_type;

public:
    static value_type   minimum() { return __STLSOFT_LIMIT_TRAITS__UINT8_MIN; }
    static value_type   maximum() { return __STLSOFT_LIMIT_TRAITS__UINT8_MAX; }

#ifdef STLSOFT_CF_MEMBER_CONSTANT_SUPPORT
    static const value_type minimum_value = __STLSOFT_LIMIT_TRAITS__UINT8_MIN;
    static const value_type maximum_value = __STLSOFT_LIMIT_TRAITS__UINT8_MAX;
#endif /* STLSOFT_CF_MEMBER_CONSTANT_SUPPORT */
};

/* s/uint16 */
STLSOFT_TEMPLATE_SPECIALISATION
struct limit_traits<ss_sint16_t>
{
public:
    typedef ss_sint16_t value_type;

public:
    static value_type   minimum() { return __STLSOFT_LIMIT_TRAITS__SINT16_MIN; }
    static value_type   maximum() { return __STLSOFT_LIMIT_TRAITS__SINT16_MAX; }

#ifdef STLSOFT_CF_MEMBER_CONSTANT_SUPPORT
    static const value_type minimum_value = __STLSOFT_LIMIT_TRAITS__SINT16_MIN;
    static const value_type maximum_value = __STLSOFT_LIMIT_TRAITS__SINT16_MAX;
#endif /* STLSOFT_CF_MEMBER_CONSTANT_SUPPORT */
};

STLSOFT_TEMPLATE_SPECIALISATION
struct limit_traits<ss_uint16_t>
{
public:
    typedef ss_uint16_t value_type;

public:
    static value_type   minimum() { return __STLSOFT_LIMIT_TRAITS__UINT16_MIN; }
    static value_type   maximum() { return __STLSOFT_LIMIT_TRAITS__UINT16_MAX; }

#ifdef STLSOFT_CF_MEMBER_CONSTANT_SUPPORT
    static const value_type minimum_value = __STLSOFT_LIMIT_TRAITS__UINT16_MIN;
    static const value_type maximum_value = __STLSOFT_LIMIT_TRAITS__UINT16_MAX;
#endif /* STLSOFT_CF_MEMBER_CONSTANT_SUPPORT */
};

/* s/uint32 */
STLSOFT_TEMPLATE_SPECIALISATION
struct limit_traits<ss_sint32_t>
{
public:
    typedef ss_sint32_t value_type;

public:
    static value_type   minimum() { return __STLSOFT_LIMIT_TRAITS__SINT32_MIN; }
    static value_type   maximum() { return __STLSOFT_LIMIT_TRAITS__SINT32_MAX; }

#ifdef STLSOFT_CF_MEMBER_CONSTANT_SUPPORT
    static const value_type minimum_value = __STLSOFT_LIMIT_TRAITS__SINT32_MIN;
    static const value_type maximum_value = __STLSOFT_LIMIT_TRAITS__SINT32_MAX;
#endif /* STLSOFT_CF_MEMBER_CONSTANT_SUPPORT */
};

STLSOFT_TEMPLATE_SPECIALISATION
struct limit_traits<ss_uint32_t>
{
public:
    typedef ss_uint32_t value_type;

public:
    static value_type   minimum() { return __STLSOFT_LIMIT_TRAITS__UINT32_MIN; }
    static value_type   maximum() { return __STLSOFT_LIMIT_TRAITS__UINT32_MAX; }

#ifdef STLSOFT_CF_MEMBER_CONSTANT_SUPPORT
    static const value_type minimum_value = __STLSOFT_LIMIT_TRAITS__UINT32_MIN;
    static const value_type maximum_value = __STLSOFT_LIMIT_TRAITS__UINT32_MAX;
#endif /* STLSOFT_CF_MEMBER_CONSTANT_SUPPORT */
};

#ifdef STLSOFT_CF_64BIT_INT_SUPPORT

/* s/uint64 */
STLSOFT_TEMPLATE_SPECIALISATION
struct limit_traits<ss_sint64_t>
{
public:
    typedef ss_sint64_t value_type;

public:
    static value_type   minimum() { return __STLSOFT_LIMIT_TRAITS__SINT64_MIN; }
    static value_type   maximum() { return __STLSOFT_LIMIT_TRAITS__SINT64_MAX; }

#if defined(STLSOFT_CF_MEMBER_CONSTANT_SUPPORT) && \
    !defined(__STLSOFT_COMPILER_IS_BORLAND)
    static const value_type minimum_value = __STLSOFT_LIMIT_TRAITS__SINT64_MIN;
    static const value_type maximum_value = __STLSOFT_LIMIT_TRAITS__SINT64_MAX;
#endif /* STLSOFT_CF_MEMBER_CONSTANT_SUPPORT */
};

STLSOFT_TEMPLATE_SPECIALISATION
struct limit_traits<ss_uint64_t>
{
public:
    typedef ss_uint64_t value_type;

public:
    static value_type   minimum() { return __STLSOFT_LIMIT_TRAITS__UINT64_MIN; }
    static value_type   maximum() { return __STLSOFT_LIMIT_TRAITS__UINT64_MAX; }

#if defined(STLSOFT_CF_MEMBER_CONSTANT_SUPPORT) && \
    !defined(__STLSOFT_COMPILER_IS_BORLAND)
    static const value_type minimum_value = __STLSOFT_LIMIT_TRAITS__UINT64_MIN;
    static const value_type maximum_value = __STLSOFT_LIMIT_TRAITS__UINT64_MAX;
#endif /* STLSOFT_CF_MEMBER_CONSTANT_SUPPORT */
};
#endif /* STLSOFT_CF_64BIT_INT_SUPPORT */

#endif /* !__STLSOFT_DOCUMENTATION_SKIP_SECTION */

/* 

#ifndef _STLSOFT_NO_NAMESPACE
} // namespace stlsoft
#endif /* _STLSOFT_NO_NAMESPACE */

/* 

#endif /* !STLSOFT_INCL_H_STLSOFT_LIMIT_TRAITS */

/* 

STLSoft Libraries documentation © Synesis Software Pty Ltd, 2001-2004