FormatUtils.h

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

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

#ifndef CNTM_FORMATUTILS_H
#define CNTM_FORMATUTILS_H
#include <string>
#include <sstream>

namespace Cntm
{

        /**
         *@author Овсеевич Р. 
         */
        struct FormatMsgPrmConvertor
        {
                /**
                 * Строка, содержащая преобразованный параметр.
                 */
                std::string Str;

                /**
                 * Конструктор по умолчанию.
                 */
                FormatMsgPrmConvertor() {}

                /**
                 * Конструктор преобразования типа T в строку.
                 */
                template <typename T> FormatMsgPrmConvertor(const T& Prm);
        };

        template <class T>
        FormatMsgPrmConvertor::FormatMsgPrmConvertor(const T& Prm)
        {
                std::ostringstream PrmConv;     // Создаем строковый поток
                PrmConv << Prm;                         // Конвертируем параметр в строковый поток
                Str = PrmConv.str();            // Преобразовываем к строке
        }

        /**
         * Форматирование строки с 0..2 параметрами (место вставки параметров - "%%Index", Index = 1..8).
         *
         * Для преобразования аргументов в строку используется промежуточный тип FmtMsgPrm, в конструкторе которого вызывается оператор << для basic_ostream<char>. Тип аргумента должен поддерживать эту операцию.
         */
        std::string FormatMsg(const std::string& Fmt,
                const FormatMsgPrmConvertor& Prm1 = FormatMsgPrmConvertor(),
                const FormatMsgPrmConvertor& Prm2 = FormatMsgPrmConvertor());

        /**
         * Форматирование строки с 3..4 параметрами.
         *
         * Для преобразования аргументов в строку используется промежуточный тип FmtMsgPrm, в конструкторе которого вызывается оператор << для basic_ostream<char>. Тип аргумента должен поддерживать эту операцию.
         */
        std::string FormatMsg(const std::string& Fmt,
                const FormatMsgPrmConvertor& Prm1,
                const FormatMsgPrmConvertor& Prm2,
                const FormatMsgPrmConvertor& Prm3,
                const FormatMsgPrmConvertor& Prm4 = FormatMsgPrmConvertor());

        /**
         * Форматирование строки с 5..8 параметрами.
         *
         * Для преобразования аргументов в строку используется промежуточный тип FmtMsgPrm, в конструкторе которого вызывается оператор << для basic_ostream<char>. Тип аргумента должен поддерживать эту операцию.
         */
        std::string FormatMsg(const std::string& Fmt,
                const FormatMsgPrmConvertor& Prm1,
                const FormatMsgPrmConvertor& Prm2,
                const FormatMsgPrmConvertor& Prm3,
                const FormatMsgPrmConvertor& Prm4,
                const FormatMsgPrmConvertor& Prm5,
                const FormatMsgPrmConvertor& Prm6 = FormatMsgPrmConvertor(),
                const FormatMsgPrmConvertor& Prm7 = FormatMsgPrmConvertor(),
                const FormatMsgPrmConvertor& Prm8 = FormatMsgPrmConvertor());

        /**
         * Класс для хранения форматных строк (содержащих текст сообщения и указатели места вставки параметров, имеющие вид "%%Index", Index = 1..8), потомок std::string.
         *
         * Оператор (...) используется для подстановки реальных значений параметров.
         *
         * Пример: FormatString fsGenericError = "Общая ошибка: %%2, приоритет: %%1, user: %%3");
         * throw exception(fsGenericError(3, "Ошибка параметра", fCurrentUser));.
         * @author Овсеевич Р.
         */
        class FormatString: public std::string
        {
        public:

                /**
                 * Конструктор по умолчанию.
                 */
                FormatString(): std::string() {}

                /**
                 * Конструктор из обычной строки.
                 */
                FormatString(const char* Str): std::string(Str) {}

                /**
                 * Конструктор копирования.
                 */
                FormatString(const std::string& Str): std::string(Str) {}

                /**
                 * Оператор подстановки 0..2 параметров.
                 *
                 * Для преобразования аргументов в строку используется промежуточный тип FmtMsgPrm, в конструкторе которого вызывается оператор << для basic_ostream<char>. Тип аргумента должен поддерживать эту операцию.
                 */
                std::string operator()(
                        const FormatMsgPrmConvertor& Prm1 = FormatMsgPrmConvertor(),
                        const FormatMsgPrmConvertor& Prm2 = FormatMsgPrmConvertor()) const
                        { return FormatMsg(*this, Prm1, Prm2); }

                /**
                 * Оператор подстановки 3..4 параметров.
                 *
                 * Для преобразования аргументов в строку используется промежуточный тип FmtMsgPrm, в конструкторе которого вызывается оператор << для basic_ostream<char>. Тип аргумента должен поддерживать эту операцию.
                 */
                std::string operator()(
                        const FormatMsgPrmConvertor& Prm1,
                        const FormatMsgPrmConvertor& Prm2,
                        const FormatMsgPrmConvertor& Prm3,
                        const FormatMsgPrmConvertor& Prm4 = FormatMsgPrmConvertor()) const
                        { return FormatMsg(*this, Prm1, Prm2, Prm3, Prm4); }

                /**
                 * Оператор подстановки 5..8 параметров.
                 *
                 * Для преобразования аргументов в строку используется промежуточный тип FmtMsgPrm, в конструкторе которого вызывается оператор << для basic_ostream<char>. Тип аргумента должен поддерживать эту операцию.
                 */
                std::string operator()(
                        const FormatMsgPrmConvertor& Prm1,
                        const FormatMsgPrmConvertor& Prm2,
                        const FormatMsgPrmConvertor& Prm3,
                        const FormatMsgPrmConvertor& Prm4,
                        const FormatMsgPrmConvertor& Prm5,
                        const FormatMsgPrmConvertor& Prm6 = FormatMsgPrmConvertor(),
                        const FormatMsgPrmConvertor& Prm7 = FormatMsgPrmConvertor(),
                        const FormatMsgPrmConvertor& Prm8 = FormatMsgPrmConvertor()) const
                        { return FormatMsg(*this, Prm1, Prm2, Prm3, Prm4, Prm5, Prm6, Prm7, Prm8); }
        };

}

#endif //CNTM_FORMATUTILS_H

---