StrFormat.h

Go to the documentation of this file.

//
//
 
#ifndef _INC_StrFormat_H
#define _INC_StrFormat_H
#ifndef NO_PRAGMA_ONCE
#pragma once
#endif
 
#include "StrChar.h"
#include "StrConst.h"
#include "cDebugAssert.h"
 
namespace Gray
{
        struct GRAYCORE_LINK StrFormatBase
        {
 
        public:
                static const char k_Specs[16]; // "EFGXcdefgiosux"  // Omit "S" "apnA"
 
                char m_nSpec;           
 
                BYTE m_nWidthMin;       
                short m_nPrecision;     
 
                // Flags.
                BYTE m_nLong;           
                bool m_bAlignLeft;      
                bool m_bPlusSign;       
                bool m_bLeadZero;       
                bool m_bWidthArg;       
                bool m_bAddPrefix;      
 
        public:
                static inline char FindSpec(char ch) noexcept
                {
                        for (size_t i = 0; i < _countof(k_Specs) - 1; i++)
                        {
                                const char chCur = k_Specs[i];
                                if (ch > chCur) // keep looking.
                                        continue;
                                if (ch < chCur) // they are sorted.
                                        return '\0';
                                return ch;
                        }
                        return '\0';    // nothing.
                }
        };
 
        template< typename TYPE = char >
        class GRAYCORE_LINK StrFormat : public StrFormatBase
        {
 
        public:
                typedef StrLen_t(_cdecl *STRFORMAT_t)(TYPE* pszOut, StrLen_t iLenOutMax, const TYPE* pszFormat, ...);   // for testing.
 
        public:
                StrLen_t ParseParam(const TYPE* pszFormat);
                StrLen_t RenderString(TYPE* pszOut, StrLen_t nLenOutMax, const TYPE* pszParam, StrLen_t nParamLen, short nPrecision) const;
                StrLen_t RenderUInt(TYPE* pszOut, StrLen_t nLenOutMax, const TYPE* pszPrefix, RADIX_t nRadix, char chRadixA, UINT64 uVal) const;
                StrLen_t RenderFloat(TYPE* pszOut, StrLen_t nLenOutMax, char chRadixA, double dVal) const;
 
                StrLen_t RenderParam(TYPE* pszOut, StrLen_t nLenOutMax, va_list* pvlist) const;
 
                static StrLen_t GRAYCALL FormatV(TYPE* pszOut, StrLen_t nLenOutMax, const TYPE* pszFormat, va_list vlist);
                static StrLen_t _cdecl FormatF(TYPE* pszOut, StrLen_t nLenOutMax, const TYPE* pszFormat, ...);
 
                UNITTEST_FRIEND(StrFormat);
        };
}
 
#endif