Subversion Repositories spk

#pragma once

#include <string>

#include <vector>

enum {

	COMPARE_SAME		= 0,

	COMPARE_NEWER		= 1,

	COMPARE_OLDER		= -1,

};

#pragma warning( push )

#pragma warning( disable : 4251)

namespace XLib {

/**

 * String wrapper class

 */

class SPKEXPORT String : public std::wstring

{

public:

	// constructors

	String(void);

	String(const char *str);

	String(const unsigned char *str);

	String(const std::string &str);

	String(const char c);

	String(const unsigned char c);

	String(const String& str);

	String(const wchar_t* str);

	String(const wchar_t c);

	String(const std::wstring& str);

	String(long l);

	String(unsigned long l);

	String(float f);

	String(double f);

	virtual ~String(void);

	// conversion functions

	void fromString(const std::string& str);

	void fromLong(long l);

	const String &fromFloat(float f, int dp = -1);

	void fromDouble(double f);

	const String &fromDouble(double f, int dp);

	const String &format(const char *sFormat, ...);

	const String args(const String *args, int max) const;

	const String &arg(const String &s1);

	const String &arg(const String &s1, const String &s2);

	const String &arg(const String &s1, const String &s2, const String &s3);

	const String &arg(const String &s1, const String &s2, const String &s3, const String &s4);

	const String &arg(const String &s1, const String &s2, const String &s3, const String &s4, const String &s5);

	static String PadNumber(long iNum, int iAmount);

	static String Number(long l) { return String(l); }

	static String Format(const char *sFormat, ...);

	static String Null();

	static String FromFloat(float f, int dp = -1);

	bool toBool() const;

	long toLong() const;

	int toInt() const;

	double toDouble() const;

	float toFloat() const;

	std::string toString() const;

	// casting operators

	inline operator const wchar_t *() const			{ return (const wchar_t *)this->c_str(); }

	inline operator wchar_t *() const				{ return (wchar_t *)this->c_str(); }

	inline operator const char *() const			{ return (const char *)this->toString().c_str(); }

	inline operator char *() const					{ return (char *)this->toString().c_str(); }

	inline operator const unsigned char *() const	{ return (const unsigned char *)this->toString().c_str(); }

	inline operator unsigned char *() const			{ return (unsigned char *)this->toString().c_str(); }

	inline operator const std::string &() const		{ return this->toString(); }

	inline operator const std::wstring &() const	{ return (*this); }

	inline operator const int () const				{ return this->toLong(); }

	inline operator const long () const				{ return this->toLong(); }

	inline operator const double () const			{ return this->toDouble(); }

	inline operator const float () const			{ return this->toFloat(); }

	inline operator const bool () const				{ return (this->empty() ? false : ((this->toLong()) ? true : false)); }

	// assignment operators

	const String &operator= ( const String &str );

	const String &operator= ( const std::string &str );

	const String &operator= ( const char *str );

	const String &operator= ( const unsigned char *str );

	const String &operator= ( unsigned char c );

	const String &operator= ( char c );

	const String &operator= ( long l );

	const String &operator= ( unsigned long l );

	const String &operator= ( float l );

	const String &operator= ( double l );

	// subscript operators

	const unsigned char operator[] ( int num ) const;

	unsigned char &operator[] ( int num );

	// addition operators

	String operator+ ( const char *str ) const;

	String operator+ ( const unsigned char *str ) const;

	String operator+ ( const std::string &str ) const;

	String operator+ ( const String &str ) const;

	String operator+ ( const char c ) const;

	String operator+ ( const unsigned char c ) const;

	String operator+ ( const long l ) const;

	String operator+ ( const unsigned long l ) const;

	String operator+ ( const float f ) const;

	String operator+ ( const double f ) const;

	// compound operators

	const String &operator+= ( const char *str );

	const String &operator+= ( const unsigned char *str );

	const String &operator+= ( const std::string &str );

	const String &operator+= ( const String &str );

	const String &operator+= ( const char c );

	const String &operator+= ( const unsigned char c );

	const String &operator+= ( const long l );

	const String &operator+= ( const unsigned long l );

	const String &operator+= ( const float f );

	const String &operator+= ( const double f );

	// comparison operators

	bool operator== ( const char *str ) const;

	bool operator== ( const unsigned char *str ) const;

	bool operator== ( const std::string &str ) const;

	bool operator== ( const String &str ) const;

	bool operator!= ( const char *str ) const;

	bool operator!= ( const unsigned char *str ) const;

	bool operator!= ( const std::string &str ) const;

	bool operator!= ( const String &str ) const;

	bool operator !() const;

	bool Compare(const String &str, bool bCaseSensative = false) const;

	bool Compare(const unsigned char *str, bool bCaseSensative = false) const;

	bool Compare(const char *str, bool bCaseSensative = false) const;

	// file handling

	unsigned char *readToEndOfLine(unsigned char *data);

	char *readToEndOfLine(char *data);

	const String &readToEndOfLine(FILE *id, int *line, bool upper);

	// tokens

	int countToken(const char *token) const;

	String token(const char *token, int tok) const;

	String tokens(const char *token, int from, int to = 0) const;

	String *tokenise(const char *token, int *max) const;

	std::vector<XLib::String> tokenise(const XLib::String& token) const;

	String replaceToken(const char *token, int from, const String &replace) const;

	String remToken(const char *token, int t) const;

	String word(int word) const;

	String words(int from, int to = 0) const;

	String addToken(const char *token, const XLib::String &str) const;

	// find/replacement

	int findPos(const String &find, int iStartPos = 0) const;

	String findReplace(const String &find, const String &replace ) const;

	String remove(char c) const;

	const String &removeChar(char c);

	const String &removeChar(const char *cs);

	String findRemove(const String &find) const;

	String stripHtml() const;

	String removeIf(int iChar, char c) const;

	bool containsAny(const String &str, bool bCaseSensative = false) const;

	bool contains(const String &str, bool bCaseSensative = false) const;

	bool contains(char c, bool bCaseSensative = false) const;

	bool isin(const String &str, bool bCaseSensative = false) const;

	bool isin(char c, bool bCaseSensative = false) const;

	int compareVersion(const XLib::String &v) const;

	bool match(const XLib::String &pattern) const;

	// sub string

	String left(long num) const;

	String right(int num) const;

	String mid(int start, int end) const;

	String between(const String &before, const String &after) const;

	bool isNumber(bool integer = false) const;

	bool isCharNumber(int c) const;

	const String &removeFirstSpace();

	const String &removeEndSpace();

	const String &truncate(int iNum);

	const String &padNumber(int iNum);

	const String &pad(int iAmoumt, char cWith);

	String lower() const;

	String upper() const;

	const String &toLower();

	const String &toUpper();

	const String &toFilename();

	String asFilename() const;

private:

	bool _isCharNumber(char c) const;

	XLib::String::size_type _token_nextPos(const char *token, XLib::String::size_type curPos) const;

};

SPKEXPORT String operator+(const char *str1, const String &str2);

typedef std::vector<XLib::String> StringList;

#pragma warning( pop )

}