MathUtils.h

См. документацию.

/*
 * CntmLib - Подсчет ссылок, потоки, синхронизация, асинхронные процедуры, события
 * Copyright (c) 2005, Овсеевич Роман, CntmLib@mail.ru
 * _______________________________________________________________________________
 * Разрешено свободное использование, копирование, распространение, изменение
 * (изменение сведений об авторских правах запрещено). Запрещена продажа и 
 * включение всей библиотеки или ее частей в другие библиотеки. В сведениях об
 * авторских правах на программу (или сведениях о программе, об авторах, 
 * использованных средствах разработки и т.д.) должна быть указана информация
 * о библиотеке CntmLib, ее авторе и, возможно, сайте или email'е.
 * Библиотека поставляется "как есть", без каких-либо гарантий со стороны автора.
 */ 

#ifndef CNTM_MATHUTILS_H
#define CNTM_MATHUTILS_H

namespace Cntm
{

        /**
         * Минимум.
         * \ingroup Utils
         */
        template < typename Type >
                inline const Type & Min(const Type & value1, const Type & value2)
        {
                return (value1 < value2) ? value1 : value2;
        }

        /**
         * Максимум.
         * \ingroup Utils
         */
        template < typename Type >
                inline const Type & Max(const Type & value1, const Type & value2)
        {
                return (value1 > value2) ? value1 : value2;
        }

        /**
         * Целочисленное деление с округлением в большую сторону.
         * \ingroup Utils
         */
        template < typename Type >
                inline Type DivIntGreatRound(Type value1, Type value2)
        {
                return (value1 + value2 - 1) / value2;
        }

        /**
         * Обмен эл-тов.
         * \ingroup Utils
         */
        template < typename Type >
                inline void Exchange(Type & value1, Type & value2)
        {
                Type temp = value1;
                value1 = value2;
                value2 = temp;
        }

        /**
         * Функции работы с отрезком (оба конца входят в отрезок).
         * Проверить значение на попадание в пределы отрезка.
         * \ingroup Utils
         */
        template < typename Type >
                inline bool InRange(const Type & value, const Type & low, const Type & high)
        {
                return !OutRange(value, low, high);
        }

        /**
         * Проверить значение на выход за пределы отрезка (оба конца входят в отрезок).
         * \ingroup Utils
         */
        template < typename Type >
                inline bool OutRange(const Type & value, const Type & low, const Type & high)
        {
                return ((low > value) || (value > high));
        }

        /**
         * Отсечь значение по указанным пределам отрезка (оба конца входят в отрезок).
         * \ingroup Utils
         */
        template < typename Type >
                inline const Type & TrimRange(const Type & value, const Type & low, const Type & high)
        {
                return Max(low, Min(value, high));
        }

        /**
         * Индекс отрезка. Результат: -1 - до граниицы, 0 - на границе, 1 - после границы.
         * \ingroup Utils
         */
        template < typename Type >
                inline int RangeIndex(const Type & value, const Type & bound)
        {
                if (value < bound) return -1;
                else if (value > bound) return 1;
                else return 0;
        }

        /**
         * Индекс отрезка (оба конца входят в отрезок). Результат: -1 - до low граниицы, 0 - в отрезке, 1 - после high границы.
         * \ingroup Utils
         */
        template < typename Type >
                inline int RangeIndex(const Type & value, const Type & low, const Type & high)
        {
                if (value < low) return -1;
                else if (value > high) return 1;
                else return 0;
        }

        /**
         * Функции работы с интервалом (левый конец входит в интервал, правый - нет).
         * Проверить значение на попадание в пределы интервала.
         * \ingroup Utils
         */
        template < typename Type >
                inline bool InInterval(const Type & value, const Type & low, const Type & high)
        {
                return !OutInterval(value, low, high);
        }

        /**
         * Проверить значение на выход за пределы интервала (левый конец входит в интервал, правый - нет).
         * \ingroup Utils
         */
        template < typename Type >
                inline bool OutInterval(const Type & value, const Type & low, const Type & high)
        {
                return ((low > value) || !(value < high));
        }

        /**
         * Индекс интервала (левый конец входит в интервал, правый - нет). Результат: -1 - до low граниицы, 0 - в интервале, 1 - после или на high границе.
         * \ingroup Utils
         */
        template < typename Type >
                inline int IntervalIndex(const Type & value, const Type & low, const Type & high)
        {
                if (value < low) return -1;
                else if (value < high) return 0;
                else return 1;
        }

}

#endif //CNTM_MATHUTILS_H

---