core/ASCFontConverter/StringExt.h

#ifndef _STRING_EXT_H
#define _STRING_EXT_H

#include <stdarg.h>

//---------------------------------------------------------------------------------------
// класс StringExt - аналог CString
//---------------------------------------------------------------------------------------

class StringExt 
{

public:

	// Создаем пустую строку.
	StringExt();

	// Создаем строку из Сишной строки.
	StringExt(const char *sString);

	// Создаем строку из <nLength> символов в <sString>. Данная строка
	// может содержать нулевые символы.
	StringExt(const char *sString, int nLength);

	// Создаем строку из <nLength> символов, начиная с <nIndex>, строки <seString>.
	StringExt(StringExt *seString, int nIndex, int nLength);
	
	// Копируем строку.
	StringExt(StringExt *seString);
	StringExt *Copy() 
	{ 
		return new StringExt(this); 
	}

	// Соединяем две строки.
	StringExt(StringExt *seString1, StringExt *seString2);

	// Переводим целое значение в строку.
	static StringExt *FromInt(int nValue);

	// Создаем форматированную строку. Функция подобна printf, но без проблем
	// с переполнением строки. Формат выглядит следующим образом:
	//     {<nArg>:[<nWidth>][.<precision>]<type>}
	// где:
	// - <nArg> номер аргумента (нумерация начинается с 0).
	// -- PS: сами аргументы должны идти по порядку, а использовать их можно
	//    многократно и в любом порядке.
	// - <nWidth> ширина поля, если она отрицательна, тогда прилежание будет
	//   сменено на противоположное, а пустые места будут заполнены нулями.
	// - <nPrecision> количество знаков после запятой
	// - <nType> тип один из слудющих:
	//     d, x, o, b -- целое(int) в десятичной, шестнадцатиричной, восьмиричной
    //                   и двоичной системах исчисления
	//     ud, ux, uo, ub -- тоже самое, только беззнаковое целое(uint)
	//     ld, lx, lo, lb, uld, ulx, ulo, ulb -- аналогичной long и ulong
	//     f, g -- double
	//     c -- char
	//     s -- string (char *)
	//     t -- StringExt *
	//     w -- Пробелы; значение аргументы означает количество пробелов
	// Для вывода фигурных скобок надо использовать {{ и }}.
	static StringExt *Format (char *sFormat, ...);
	static StringExt *FormatV(char *sFormat, va_list sArgList);

	// Деструктор.
	~StringExt();

	int GetLength() 
	{ 
		return m_nLength; 
	}

	// Возвращаем строку в виде char*.
	char *GetBuffer() 
	{ 
		return m_sData; 
	}

	char GetAt(int nIndex) 
	{ 
		return m_sData[ nIndex ]; 
	}
	void SetAt(int nIndex, char nChar) 
	{ 
		m_sData[ nIndex ] = nChar; 
	}

	// Очищаем строку.
	StringExt *Clear();

	// Добавляем символ или строку.
	StringExt *Append(char nChar);
	StringExt *Append(StringExt *seString);
	StringExt *Append(const char *sString);
	StringExt *Append(const char *sString, int nLength);

	// Добавляем форматированную строку.
	StringExt *AppendFormat (char *sFormat, ...);
	StringExt *AppendFormatV(char *sFormat, va_list sArgList);

	// Вставляем символ или строку.
	StringExt *Insert(int nIndex, char nChar);
	StringExt *Insert(int nIndex, StringExt  *seString);
	StringExt *Insert(int nIndex, const char *sString);
	StringExt *Insert(int nIndex, const char *sString, int nLength);

	// Удаляем один символ или массив символов.
	StringExt *Delete(int nIndex, int nCount = 1);

	// Делаем в строке все символы большими/маленькими буквами.
	StringExt *MakeUpper();
	StringExt *MakeLower();

	// Сравнение двух строк:  -1:<  0:=  +1:>
	int Compare (StringExt *seString);
	int CompareN(StringExt *seString, int nCount);
	int Compare (const char *sString);
	int CompareN(const char *sString, int nCount);

private:

	void Resize(int nLength);

	static void FormatInt   (         long nValue, char *sBuffer, int nBufferSize, BOOL bZeroFill, int nWidth, int nBase, char **ppData, int *nLen);	
	static void FormatUInt  (unsigned long nValue, char *sBuffer, int nBufferSize, BOOL bZeroFill, int nWidth, int nBase, char **ppData, int *nLen);
	static void FormatDouble(       double nValue, char *sBuffer, int nBufferSize, int nPrecision, BOOL bTrim,            char **ppData, int *nLen);

private:

	int   m_nLength;
	char *m_sData;

};

#endif /* _STRING_EXT_H */