/*==LICENSE==* CyanWorlds.com Engine - MMOG client, server and tools Copyright (C) 2011 Cyan Worlds, Inc. This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see . Additional permissions under GNU GPL version 3 section 7 If you modify this Program, or any covered work, by linking or combining it with any of RAD Game Tools Bink SDK, Autodesk 3ds Max SDK, NVIDIA PhysX SDK, Microsoft DirectX SDK, OpenSSL library, Independent JPEG Group JPEG library, Microsoft Windows Media SDK, or Apple QuickTime SDK (or a modified version of those libraries), containing parts covered by the terms of the Bink SDK EULA, 3ds Max EULA, PhysX SDK EULA, DirectX SDK EULA, OpenSSL and SSLeay licenses, IJG JPEG Library README, Windows Media SDK EULA, or QuickTime SDK EULA, the licensors of this Program grant you additional permission to convey the resulting work. Corresponding Source for a non-source form of such a combination shall include the source code for the parts of OpenSSL and IJG JPEG Library used as well as that of the covered work. You can contact Cyan Worlds, Inc. by email legal@cyan.com or by snail mail at: Cyan Worlds, Inc. 14617 N Newport Hwy Mead, WA 99021 *==LICENSE==*/ #include "plFormat.h" #include "HeadSpin.h" #include #include #define BADCHAR_REPLACEMENT (0xFFFDul) namespace plFormat_Private { static const char *_scanNextFormat(_IFormatDataObject &data) { hsAssert(data.fFormatStr, "Passed a null format string!"); const char *ptr = data.fFormatStr; while (*ptr) { if (*ptr == '{') return ptr; ++ptr; } return ptr; } static void _fetchPrefixChunk(_IFormatDataObject &data) { do { const char *next = _scanNextFormat(data); if (*next && *(next + 1) == '{') { // Escaped '{' data.fOutput.push_back(plStringBuffer(data.fFormatStr, 1 + next - data.fFormatStr)); data.fFormatStr = next + 2; continue; } if (next != data.fFormatStr) data.fOutput.push_back(plStringBuffer(data.fFormatStr, next - data.fFormatStr)); data.fFormatStr = next; } while (0); } FormatSpec _FetchNextFormat(_IFormatDataObject &data) { _fetchPrefixChunk(data); hsAssert(*data.fFormatStr == '{', "Too many actual parameters for format string"); FormatSpec spec; const char *ptr = data.fFormatStr; for ( ;; ) { ++ptr; switch (*ptr) { case 0: hsAssert(0, "Unterminated format specifier."); abort(); case '}': // Done with format spec data.fFormatStr = ptr + 1; return spec; break; case '<': spec.fAlignment = kAlignLeft; break; case '>': spec.fAlignment = kAlignRight; break; case '_': spec.fPadChar = *(ptr + 1); hsAssert(spec.fPadChar, "Unterminated format specifier"); ++ptr; break; case 'x': spec.fDigitClass = kDigitHex; break; case 'X': spec.fDigitClass = kDigitHexUpper; break; case '+': spec.fDigitClass = kDigitDecAlwaysSigned; break; case 'd': if (spec.fDigitClass != kDigitDecAlwaysSigned) spec.fDigitClass = kDigitDec; break; case 'o': spec.fDigitClass = kDigitOct; break; case 'b': spec.fDigitClass = kDigitBin; break; case 'c': spec.fDigitClass = kDigitChar; break; case 'f': spec.fFloatClass = kFloatFixed; break; case 'e': spec.fFloatClass = kFloatExp; break; case 'E': spec.fFloatClass = kFloatExpUpper; break; case '0': case '1': case '2': case '3': case '4': case '5': case '6': case '7': case '8': case '9': { char *end = nullptr; spec.fPrecisionLeft = strtol(ptr, &end, 10); ptr = end - 1; } break; case '.': { hsAssert(*(ptr + 1), "Unterminated format specifier"); char *end = nullptr; spec.fPrecisionRight = strtol(ptr + 1, &end, 10); ptr = end - 1; } break; default: hsAssert(0, "Unexpected character in format string"); break; } } } plString _IFormat(plFormat_Private::_IFormatDataObject &data) { _fetchPrefixChunk(data); hsAssert(*data.fFormatStr == 0, "Not enough actual parameters for format string"); size_t outsize = 0; for (const plStringBuffer &buf : data.fOutput) outsize += buf.GetSize(); plStringBuffer outbuf; char *out_ptr = outbuf.CreateWritableBuffer(outsize); for (const plStringBuffer &buf : data.fOutput) { memcpy(out_ptr, buf.GetData(), buf.GetSize()); out_ptr += buf.GetSize(); } *out_ptr = 0; return outbuf; } } template void _IFormatNumeric_Impl(char *output_end, _IType value, int radix, bool upperCase = false) { if (value == 0) { *(output_end - 1) = '0'; return; } while (value) { int digit = (value % radix); value /= radix; --output_end; if (digit < 10) *output_end = '0' + digit; else if (upperCase) *output_end = 'A' + digit - 10; else *output_end = 'a' + digit - 10; } } template static plStringBuffer _formatNumeric(const plFormat_Private::FormatSpec &format, _IType value, int radix, bool upperCase = false) { char pad = format.fPadChar ? format.fPadChar : ' '; size_t max = 0; _IType temp = value; while (temp) { ++max; temp /= radix; } if (max == 0) max = 1; plStringBuffer buffer; if (format.fPrecisionLeft > max) { char *output = buffer.CreateWritableBuffer(format.fPrecisionLeft); memset(output, pad, format.fPrecisionLeft); if (format.fAlignment == plFormat_Private::kAlignLeft) { _IFormatNumeric_Impl<_IType>(output + max, value, radix, upperCase); } else { _IFormatNumeric_Impl<_IType>(output + format.fPrecisionLeft, value, radix, upperCase); } output[format.fPrecisionLeft] = 0; } else { char *output = buffer.CreateWritableBuffer(max); _IFormatNumeric_Impl<_IType>(output + max, value, radix, upperCase); output[max] = 0; } return buffer; } // Currently, only decimal formatting supports rendering negative numbers template static plStringBuffer _formatDecimal(const plFormat_Private::FormatSpec &format, _IType value) { char pad = format.fPadChar ? format.fPadChar : ' '; _IType abs = (value < 0) ? -value : value; size_t max = 0; _IType temp = abs; while (temp) { ++max; temp /= 10; } if (max == 0) max = 1; if (value < 0 || format.fDigitClass == plFormat_Private::kDigitDecAlwaysSigned) ++max; plStringBuffer buffer; char *output; if (format.fPrecisionLeft > max) { output = buffer.CreateWritableBuffer(format.fPrecisionLeft); memset(output, pad, format.fPrecisionLeft); if (format.fAlignment == plFormat_Private::kAlignLeft) _IFormatNumeric_Impl<_IType>(output + max, abs, 10); else _IFormatNumeric_Impl<_IType>(output + format.fPrecisionLeft, abs, 10); output[format.fPrecisionLeft] = 0; } else { output = buffer.CreateWritableBuffer(max); _IFormatNumeric_Impl<_IType>(output + max, abs, 10); output[max] = 0; } int signPos = format.fPrecisionLeft - static_cast(max); if (signPos < 0) signPos = 0; if (value < 0) output[signPos] = '-'; else if (format.fDigitClass == plFormat_Private::kDigitDecAlwaysSigned) output[signPos] = '+'; return buffer; } static plStringBuffer _formatChar(const plFormat_Private::FormatSpec &format, int ch) { hsAssert(format.fPrecisionLeft == 0 && format.fPadChar == 0, "Char formatting does not currently support padding"); // Don't need to nul-terminate this, since plStringBuffer's constructor fixes it char utf8[4]; size_t max; // Yanked from plString if (ch > 0x10FFFF) { hsAssert(0, "Unicode character out of range"); // Character out of range; Use U+FFFD instead for release builds max = 3; utf8[0] = 0xE0 | ((BADCHAR_REPLACEMENT >> 12) & 0x0F); utf8[1] = 0x80 | ((BADCHAR_REPLACEMENT >> 6) & 0x3F); utf8[2] = 0x80 | ((BADCHAR_REPLACEMENT ) & 0x3F); } else if (ch > 0xFFFF) { max = 4; utf8[0] = 0xF0 | ((ch >> 18) & 0x07); utf8[1] = 0x80 | ((ch >> 12) & 0x3F); utf8[2] = 0x80 | ((ch >> 6) & 0x3F); utf8[3] = 0x80 | ((ch ) & 0x3F); } else if (ch > 0x7FF) { max = 3; utf8[0] = 0xE0 | ((ch >> 12) & 0x0F); utf8[1] = 0x80 | ((ch >> 6) & 0x3F); utf8[2] = 0x80 | ((ch ) & 0x3F); } else if (ch > 0x7F) { max = 2; utf8[0] = 0xC0 | ((ch >> 6) & 0x1F); utf8[1] = 0x80 | ((ch ) & 0x3F); } else { max = 1; utf8[0] = (char)ch; } return plStringBuffer(utf8, max); } #define _PL_FORMAT_IMPL_INT_TYPE(_stype, _utype) \ PL_FORMAT_IMPL(_stype) \ { \ /* Note: The use of unsigned here is not a typo -- we only format decimal \ values with a sign, so we can convert everything else to unsigned. */ \ switch (format.fDigitClass) { \ case plFormat_Private::kDigitBin: \ return _formatNumeric<_utype>(format, value, 2); \ case plFormat_Private::kDigitOct: \ return _formatNumeric<_utype>(format, value, 8); \ case plFormat_Private::kDigitHex: \ return _formatNumeric<_utype>(format, value, 16, false); \ case plFormat_Private::kDigitHexUpper: \ return _formatNumeric<_utype>(format, value, 16, true); \ case plFormat_Private::kDigitDec: \ case plFormat_Private::kDigitDecAlwaysSigned: \ case plFormat_Private::kDigitDefault: \ return _formatDecimal<_stype>(format, value); \ case plFormat_Private::kDigitChar: \ return _formatChar(format, value); \ } \ \ hsAssert(0, "Unexpected digit class"); \ return plStringBuffer(); \ } \ \ PL_FORMAT_IMPL(_utype) \ { \ switch (format.fDigitClass) { \ case plFormat_Private::kDigitBin: \ return _formatNumeric<_utype>(format, value, 2); \ case plFormat_Private::kDigitOct: \ return _formatNumeric<_utype>(format, value, 8); \ case plFormat_Private::kDigitHex: \ return _formatNumeric<_utype>(format, value, 16, false); \ case plFormat_Private::kDigitHexUpper: \ return _formatNumeric<_utype>(format, value, 16, true); \ case plFormat_Private::kDigitDec: \ case plFormat_Private::kDigitDecAlwaysSigned: \ case plFormat_Private::kDigitDefault: \ return _formatDecimal<_utype>(format, value); \ case plFormat_Private::kDigitChar: \ return _formatChar(format, value); \ } \ \ hsAssert(0, "Unexpected digit class"); \ return plStringBuffer(); \ } _PL_FORMAT_IMPL_INT_TYPE(signed char, unsigned char) _PL_FORMAT_IMPL_INT_TYPE(short, unsigned short) _PL_FORMAT_IMPL_INT_TYPE(int, unsigned) _PL_FORMAT_IMPL_INT_TYPE(long, unsigned long) #if (SIZEOF_LONG == 4) _PL_FORMAT_IMPL_INT_TYPE(int64_t, uint64_t) #endif PL_FORMAT_IMPL(char) { /* Note: The use of unsigned here is not a typo -- we only format decimal values with a sign, so we can convert everything else to unsigned. */ switch (format.fDigitClass) { case plFormat_Private::kDigitBin: return _formatNumeric(format, value, 2); case plFormat_Private::kDigitOct: return _formatNumeric(format, value, 8); case plFormat_Private::kDigitHex: return _formatNumeric(format, value, 16, false); case plFormat_Private::kDigitHexUpper: return _formatNumeric(format, value, 16, true); case plFormat_Private::kDigitDec: case plFormat_Private::kDigitDecAlwaysSigned: return _formatDecimal(format, value); case plFormat_Private::kDigitChar: case plFormat_Private::kDigitDefault: return _formatChar(format, value); } hsAssert(0, "Unexpected digit class"); return plStringBuffer(); } PL_FORMAT_IMPL(wchar_t) { switch (format.fDigitClass) { case plFormat_Private::kDigitBin: return _formatNumeric(format, value, 2); case plFormat_Private::kDigitOct: return _formatNumeric(format, value, 8); case plFormat_Private::kDigitHex: return _formatNumeric(format, value, 16, false); case plFormat_Private::kDigitHexUpper: return _formatNumeric(format, value, 16, true); case plFormat_Private::kDigitDec: case plFormat_Private::kDigitDecAlwaysSigned: return _formatDecimal(format, value); case plFormat_Private::kDigitChar: case plFormat_Private::kDigitDefault: return _formatChar(format, value); } hsAssert(0, "Unexpected digit class"); return plStringBuffer(); } static plStringBuffer _formatString(const plFormat_Private::FormatSpec &format, const plStringBuffer &value) { char pad = format.fPadChar ? format.fPadChar : ' '; if (format.fPrecisionLeft > value.GetSize()) { plStringBuffer buf; char *output = buf.CreateWritableBuffer(format.fPrecisionLeft); memset(output, pad, format.fPrecisionLeft); if (format.fAlignment == plFormat_Private::kAlignRight) { memcpy(output + (format.fPrecisionLeft - value.GetSize()), value.GetData(), value.GetSize()); } else { memcpy(output, value.GetData(), value.GetSize()); } output[format.fPrecisionLeft] = 0; return buf; } return value; } PL_FORMAT_IMPL(const char *) { return _formatString(format, plString(value).ToUtf8()); } PL_FORMAT_IMPL(const wchar_t *) { return _formatString(format, plString::FromWchar(value).ToUtf8()); } PL_FORMAT_IMPL(const plString &) { return _formatString(format, value.ToUtf8()); } PL_FORMAT_IMPL(const std::string &) { return _formatString(format, plStringBuffer(value.c_str(), value.size())); } PL_FORMAT_IMPL(const std::wstring &) { return _formatString(format, plString::FromWchar(value.c_str(), value.size()).ToUtf8()); } PL_FORMAT_IMPL(bool) { return PL_FORMAT_FORWARD(format, value ? "true" : "false"); }