IliString Class Reference

User interface class. More...

#include <ilviews/dataccess/string.h>

List of all members.

Public Member Functions
	IliString (const IliString &s)
	This is the copy constructor of class IliString.
	IliString (const char *str, IlUInt len)
	Initializes a string initialized with a string.
	IliString (const char *str)
	Initializes a string initialized with a string.
	IliString (char c)
	Initializes a string of length 1 containing a character.
	IliString ()
	Initializes an empty string.
IliString &	append (const char *str, IlUInt len)
	Appends a substring.
IliString &	append (const char *str)
	Appends the character string to the string object.
IliString &	appendHex (unsigned long l)
	Appends the character string representation (in hexadecimal) of a long integer to the string.
IlBoolean	isNull () const
	Returns IlTrue if the string is empty.
IlUInt	length () const
	Returns the length of the string in characters.
void	nullify ()
	Sets the length of the string to 0.
	operator const char * () const
	Returns the current value of the string as a pointer to an array of constant characters.
IliString &	operator<< (const IliString &s)
	Appends the string to the string object.
IliString &	operator<< (const char *str)
	Appends the character string to the string object.
IliString &	operator<< (double d)
	Appends the character string representation of the double precision value, to the string.
IliString &	operator<< (unsigned long ul)
	Appends the character string representation (in decimal) of an unsigned long integer, to the string.
IliString &	operator<< (long l)
	Appends the character string representation (in decimal) of a long integer, to the string.
IliString &	operator<< (unsigned u)
	Appends the character string representation (in decimal) of an unsigned integer, to the string.
IliString &	operator<< (int i)
	Appends an integer.
IliString &	operator<< (char c)
	Appends a character.
IliString &	operator= (const IliString &str)
	Sets the value of the IliString object with a string.
IliString &	operator= (const char *str)
	Sets the value of the IliString object with a string.
char &	operator[] (long i)
	Returns a reference to a character of the string.
const char &	operator[] (long i) const
	Returns a constant reference to a character of the string.
char &	operator[] (int i)
	Returns a reference to a character of the string.
const char &	operator[] (int i) const
	Returns a constant reference to a character of the string.
IliString &	prepend (const IliString &s)
	Prepends the character string to the string object.
IliString &	prepend (const char *str)
	Prepends the character string to the string object.
IliString &	prepend (double d)
	Prepends the character string representation of a double precision value, to the string.
IliString &	prepend (unsigned long ul)
	Prepends the character string representation (in decimal) of an unsigned long integer, to the string.
IliString &	prepend (long l)
	Prepends the character string representation (in decimal) of a long integer, to the string.
IliString &	prepend (unsigned u)
	Prepends the character string representation (in decimal) of an unsigned integer, to the string.
IliString &	prepend (int i)
	Prepends the character string representation (in decimal) of an integer, to the string.
IliString &	prepend (char c)
	Prepends a character to the string.

---

Detailed Description

User interface class.

Library: dataccess

The IliString class defines objects that manage a character string.

---

Constructor & Destructor Documentation

IliString::IliString

(

char

c

)

Initializes a string of length 1 containing a character.

Parameters:

c

The character.

IliString::IliString

(

const char *

str

)

Initializes a string initialized with a string.

Parameters:

str

The string.

IliString::IliString	(	const char *	str,
		IlUInt	len
	)

Initializes a string initialized with a string.

Parameters:

	str	The string.
	len	The maximum character count to copy.

---

Member Function Documentation

IliString& IliString::append	(	const char *	str,
		IlUInt	len
	)

Appends a substring.

Parameters:

	str	The string.
	len	The maximum character count to copy.

IliString& IliString::append

(

const char *

str

)

Appends the character string to the string object.

Parameters:

str

The string value.

Returns:

The modified object.

IliString& IliString::appendHex

(

unsigned long

l

)

Appends the character string representation (in hexadecimal) of a long integer to the string.

Parameters:

l

The long integer value.

IlBoolean IliString::isNull

(

)

const

Returns IlTrue if the string is empty.

Returns:

IlTrue if the string is empty (that is, if it has a length of 0).

IlUInt IliString::length

(

)

const

Returns the length of the string in characters.

Returns:

The length of the string in characters. The terminating NULL character is not counted.

IliString::operator const char *

(

)

const

Returns the current value of the string as a pointer to an array of constant characters.

Returns:

The current value of the string as a pointer to an array of constant characters. The return value is valid only as long as the string object has not been modified or deleted. This cast operator never returns NULL. When the string object is empty, it returns a pointer to a null-terminated character string of length 0.

IliString & IliString::operator<<

(

const IliString &

s

)

Appends the string to the string object.

Parameters:

str

The string value.

Returns:

The modified object.

IliString & IliString::operator<<

(

const char *

str

)

Appends the character string to the string object.

Parameters:

str

The string value.

Returns:

The modified object.

IliString& IliString::operator<<

(

double

d

)

Appends the character string representation of the double precision value, to the string.

Parameters:

d

The double integer.

Returns:

The modified object.

IliString& IliString::operator<<

(

unsigned long

ul

)

Appends the character string representation (in decimal) of an unsigned long integer, to the string.

Parameters:

ul

The unsigned long integer.

Returns:

The modified object.

IliString& IliString::operator<<

(

long

l

)

Appends the character string representation (in decimal) of a long integer, to the string.

Parameters:

l

The long integer.

Returns:

The modified object.

IliString& IliString::operator<<

(

unsigned

u

)

Appends the character string representation (in decimal) of an unsigned integer, to the string.

Parameters:

u

The unsigned integer.

Returns:

The modified object.

IliString& IliString::operator<<

(

int

i

)

Appends an integer.

Parameters:

i

The integer.

Returns:

The modified object.

IliString& IliString::operator<<

(

char

c

)

Appends a character.

Parameters:

c

The character.

Returns:

The modified object.

IliString& IliString::operator=

(

const IliString &

str

)

Sets the value of the IliString object with a string.

Parameters:

str

The string value.

Returns:

The modified object.

IliString& IliString::operator=

(

const char *

str

)

Sets the value of the IliString object with a string.

Parameters:

str

The string value.

Returns:

The modified object.

char & IliString::operator[]

(

long

i

)

Returns a reference to a character of the string.

Parameters:

i

The character position.

Returns:

A reference to the character. If the position is out of bounds, the return value is not meaningful.

const char & IliString::operator[]

(

long

i

)

const

Returns a constant reference to a character of the string.

Parameters:

i

The character position.

Returns:

A constant reference to the character. If the position is out of bounds, the return value is not meaningful.

char & IliString::operator[]

(

int

i

)

Returns a reference to a character of the string.

Parameters:

i

The character position.

Returns:

A reference to the character. If the position is out of bounds, the return value is not meaningful.

const char & IliString::operator[]

(

int

i

)

const

Returns a constant reference to a character of the string.

Parameters:

i

The character position.

Returns:

A constant reference to the character. If the position is out of bounds, the return value is not meaningful.

IliString& IliString::prepend

(

const IliString &

s

)

Prepends the character string to the string object.

Parameters:

str

The string.

Returns:

The modified object.

IliString& IliString::prepend

(

const char *

str

)

Prepends the character string to the string object.

Parameters:

str

The string.

Returns:

The modified object.

IliString& IliString::prepend

(

double

d

)

Prepends the character string representation of a double precision value, to the string.

Parameters:

d

The double.

Returns:

The modified object.

IliString& IliString::prepend

(

unsigned long

ul

)

Prepends the character string representation (in decimal) of an unsigned long integer, to the string.

Parameters:

ul

The unsigned long integer.

Returns:

The modified object.

IliString& IliString::prepend

(

long

l

)

Prepends the character string representation (in decimal) of a long integer, to the string.

Parameters:

l

The long integer.

Returns:

The modified object.

IliString& IliString::prepend

(

unsigned

u

)

Prepends the character string representation (in decimal) of an unsigned integer, to the string.

Parameters:

u

The unsigned integer.

Returns:

The modified object.

IliString& IliString::prepend

(

int

i

)

Prepends the character string representation (in decimal) of an integer, to the string.

Parameters:

i

The integer.

Returns:

The modified object.

IliString& IliString::prepend

(

char

c

)

Prepends a character to the string.

Parameters:

c

The character.

Returns:

The modified object.