VDKString Class Reference

Implements famous cont referenced string objects. More...

#include <vdkstring.h>

Public Member Functions
	VDKString ()
	VDKString (const char *s)
	VDKString (const char &c)
	VDKString (const VDKString &s)
VDKString &	operator= (const VDKString &s)
VDKString &	operator= (const char *s)
	~VDKString ()
	operator char * ()
int	operator== (const VDKString &s) const
int	operator< (const VDKString &s) const
int	operator> (const VDKString &s) const
int	operator<= (const VDKString &s) const
int	operator>= (const VDKString &s) const
int	operator!= (const VDKString &s) const
VDKString &	operator+= (const char *s)
VDKString &	operator+= (const VDKString &s)
VDKString	operator+ (const char *s) const
VDKString	operator+ (const VDKString &s) const
bool	isNull () const
int	size () const
char	operator[] (unsigned int ix) const
const char *	c_str () const
VDKString &	DelSelection (unsigned int begin, unsigned int len)
VDKString &	RTrim ()
VDKString &	LTrim ()
VDKString &	Trim ()
unsigned int	CharCount (const char car) const
VDKString &	UpperCase ()
VDKString &	LowerCase ()
bool	isEmpty () const
VDKString &	Concatf (const char *format,...)
VDKString &	Sprintf (const char *format,...)
VDKString &	GetPart (unsigned int i, const char sep='|')
int	GetFCharPos (const char car) const
int	GetLCharPos (const char car) const
double	StrtoDouble () const
int	StrtoInt () const
VDKString &	SubStr (unsigned int start, unsigned int len)
VDKString &	Cut (unsigned int len)
VDKString &	LPad (unsigned int len, const char car)
VDKString &	RPad (unsigned int len, const char car)
VDKString &	DoubleChar (const char car='\'')
VDKString &	FormatDate (const char sep, int orig, int ret)

Detailed Description

Implements famous cont referenced string objects.

Constructor & Destructor Documentation

VDKString() [1/4]

VDKString::VDKString

(

)

Constructor, makes an empty string

VDKString s;

VDKString() [2/4]

VDKString::VDKString

(

const char *

s

)

Constructor

Parameters

s	a null terminated C string VDKString s = "uncle bill";

VDKString() [3/4]

VDKString::VDKString

(

const char &

c

)

Constructor

Parameters

c	a single character VDKString s(c);

VDKString() [4/4]

VDKString::VDKString

(

const VDKString &

s

)

Copy-initializer

Parameters

s	a VDKString reference VDKString s = "uncle bill"; VDKString s1 = s;

~VDKString()

VDKString::~VDKString

(

)

Destructor

Member Function Documentation

c_str()

const char * VDKString::c_str

(

)

const

string pointer access for const instances

CharCount()

unsigned int VDKString::CharCount

(

const char

car

)

const

Returns the number of the specified char 'car' contained in the string.

Parameters

car	char to be counted VDKString s = "uncle bill"; int NumCar = s.CharCount('l'); // NumCar value is 3

Concatf()

VDKString & VDKString::Concatf	(	const char *	format,
			...
	)

Strcat() to the existing string (printf style). Modifies and returns the resulting VDKString.

Warning

Final string is 65534 chars max.

Returns the previous string in case of memory overflow or buffer overflow.

Parameters

format	a NULL terminated string
...	a list of parameters VDKString s = "uncle bill"; s.Concatf("%s", " is a smart boy"); // s value is "uncle bill is a smart boy"

Cut()

VDKString & VDKString::Cut

(

unsigned int

len

)

Cut the string at 'len' length. Modifies and returns the resulting VDKString.

Parameters

len	length of the resulting string

DelSelection()

VDKString & VDKString::DelSelection	(	unsigned int	begin,
		unsigned int	len
	)

Removes a part of the string, beginning at 'begin' on 'len' length. Modifies and returns the resulting VDKString.

Parameters

begin	char number where begins the selection (0 based)
len	selection length

DoubleChar()

VDKString & VDKString::DoubleChar

(

const char

car = '\''

)

Double all 'car' chars in the string (for SQL purpose). Modifies and returns the resulting VDKString.

Parameters

car	char to be doubled, '\'' (cote) by default VDKString s = "Don't do that"; VDKString p = s; p.DoublaChar(); // p value is "Don''t do that"

FormatDate()

VDKString & VDKString::FormatDate	(	const char	sep,
		int	orig,
		int	ret
	)

Returns a VDKString containing a formatted date according to parameters settings. Modifies and returns the resulting VDKString.

Warning

Only complete dates are supported. That's to say days and months on two digits and years on 4 digits. For ex. : 02/03/2000.

Parameters

sep	desired separator. If 0, no separator left
orig	date style staying in VDKString buffer
ret	date style to return VDKString s = "12/25/2000"; VDKString p = s; p.FormatDate(0, ENG_DATE, INT_DATE); // p value is "20001225" VDKString s = "12/25/2000"; VDKString p = s; p.FormatDate('-', ENG_DATE, EUR_DATE); // p value is "25-12-2000"

GetFCharPos()

int VDKString::GetFCharPos

(

const char

car

)

const

Returns the first occurrence position of the specified char 'car' (0 based) or -1 if 'car ' not found.

Parameters

car	char to be searched for

GetLCharPos()

int VDKString::GetLCharPos

(

const char

car

)

const

Returns the last occurrence position of the specified char 'car' (0 based) or -1 if 'car ' not found.

Parameters

car	char to be searched for

GetPart()

VDKString & VDKString::GetPart	(	unsigned int	i,
		const char	sep = '|'
	)

Extract the specified part of a formatted string. Modifies and returns the resulting VDKString.

Warning

Returns an isNull() string if the specified part not found.

Parameters

i	the desired part position (starting at 1)
sep	the parts separator, '|' by default VDKString s = "one|two|three|four"; VDKString p = s; p.GetPart(2); // p value is "two"

isEmpty()

bool VDKString::isEmpty

(

)

const

Returns true if this is an empty string meaning NULL buffer or strlen() == 0.

isNull()

bool VDKString::isNull

(

)

const

Returns true if this is an empty string

LowerCase()

VDKString & VDKString::LowerCase

(

)

Returns the lower case VDKString after having modify it.

Warning

Upper case characters are assumed without accents.

LPad()

VDKString & VDKString::LPad	(	unsigned int	len,
		const char	car
	)

Pad left of string with a specified char 'car' upon 'len' length. Modifies and returns the resulting VDKString.

Parameters

len	length of the resulting string
car	char to be padded

LTrim()

VDKString & VDKString::LTrim

(

)

Removes all leading spaces. Modifies and returns the resulting VDKString.

operator char *()

VDKString::operator char * ( )

inline

VDKString to char* casting warning ** can violate data hiding OO concept

operator!=()

int VDKString::operator!=

(

const VDKString &

s

)

const

disequality operator

operator+() [1/2]

VDKString VDKString::operator+

(

const char *

s

)

const

Returns a VDKString concatenated

Parameters

s	a null terminated string VDKString s = "uncle bill"; VDKString s1 = s + " is a smart boy";

operator+() [2/2]

VDKString VDKString::operator+

(

const VDKString &

s

)

const

Returns a VDKString concatenated

Parameters

s	a VDKString

operator+=() [1/2]

VDKString & VDKString::operator+=

(

const char *

s

)

cat to this

Parameters

s	a null terminated string VDKString s = "uncle bill"; s += " is a smart boy";

operator+=() [2/2]

VDKString & VDKString::operator+=

(

const VDKString &

s

)

cat to this

Parameters

s	a VDKString VDKString s = "uncle bill"; VDKString s1 = " is a smart boy"; s += s1;

operator<()

int VDKString::operator<

(

const VDKString &

s

)

const

less than operator

operator<=()

int VDKString::operator<=

(

const VDKString &

s

)

const

less-equal operator

operator=() [1/2]

VDKString & VDKString::operator=

(

const char *

s

)

Assignement operator

Parameters

s	a null terminated C string VDKString s = "uncle bill"; s = "uncle sam";

operator=() [2/2]

VDKString & VDKString::operator=

(

const VDKString &

s

)

Assignement operator

Parameters

s	a VDKString reference VDKString s = "uncle bill"; VDKString s1 = s; VDKString s2 = "uncle sam"; s = s2;

operator==()

int VDKString::operator==

(

const VDKString &

s

)

const

Equality operator

operator>()

int VDKString::operator>

(

const VDKString &

s

)

const

greater than operator

operator>=()

int VDKString::operator>=

(

const VDKString &

s

)

const

greater-equal operator

operator[]()

char VDKString::operator[]

(

unsigned int

ix

)

const

index operator for const instances returns NULL if ix >= size

RPad()

VDKString & VDKString::RPad	(	unsigned int	len,
		const char	car
	)

Pad right of string with a specified char 'car' upon 'len' length. Modifies and returns the resulting VDKString.

Parameters

len	length of the resulting string
car	char to be padded

RTrim()

VDKString & VDKString::RTrim

(

)

Removes all trailing spaces. Modifies and returns the resulting VDKString.

size()

int VDKString::size

(

)

const

as strlen()

Sprintf()

VDKString & VDKString::Sprintf	(	const char *	format,
			...
	)

Assignment to string (printf style). Modifies and returns the resulting VDKString.

Warning

Final string is 65534 chars max.

Returns the previous string in case of memory overflow or buffer overflow.

Parameters

format	a NULL terminated string
...	a list of parameters VDKString s; s.Sprintf("%s is %d years old", "uncle bill", 40); // s value is "uncle bill is 40 years old"

StrtoDouble()

double VDKString::StrtoDouble

(

)

const

Returns the converted string to double. See atof() for details.

StrtoInt()

int VDKString::StrtoInt

(

)

const

Returns the converted string to int. See atoi() for details.

SubStr()

VDKString & VDKString::SubStr	(	unsigned int	start,
		unsigned int	len
	)

Extract a part of the string beginning at 'start' upon 'len' length. Modifies and returns the resulting VDKString.

Parameters

start	first char position (0 based)
len	maximum length of the resulting string

Trim()

VDKString & VDKString::Trim

(

)

Removes all leading and trailing spaces. Modifies and returns the resulting VDKString.

UpperCase()

VDKString & VDKString::UpperCase

(

)

Returns the upper case VDKString after having modify it.

Warning

Does not modify unknown characters.

Upper case characters are assumed without accents.

---

The documentation for this class was generated from the following files:

• vdkstring.h
• vdkstring.cc