VCF::VariantData Class Reference

VariantData represents an unknown type of variable - similiar to Visual Basic's Variant object. More...

#include <vcf/FoundationKit/VariantData.h>

List of all members.

Public Types

enum { DefaultPropertyValLength = 50 }

Public Member Functions

VariantData ()

creates an empty, undefined object

VariantData (const int &val)

creates a VariantData initialized by an int value

VariantData (const unsigned int &val)

creates a VariantData initialized by an unsigned int value

VariantData (const long &val)

creates a VariantData initialized by a long value

VariantData (const unsigned long &val)

creates a VariantData initialized by an unsigned long value

VariantData (const float &val)

creates a VariantData initialized by a float value

VariantData (const double &val)

creates a VariantData initialized by a double value

VariantData (const char &val)

creates a VariantData initialized by a char value

VariantData (const bool &val)

creates a VariantData initialized by a bool value

VariantData (const short &val)

creates a VariantData initialized by a short value

VariantData (const ushort &val)

creates a VariantData initialized by a short value

VariantData (const String &val)

creates a VariantData initialized by a String value

VariantData (const char *val)

VariantData (const WideChar *val)

VariantData (const Enum &val)

creates a VariantData initialized by a Enum value

VariantData (Enum &val)

creates a VariantData initialized by a Enum value

VariantData (Enum *val)

creates a VariantData initialized by a Enum* value

VariantData (Object *val)

creates a VariantData initialized by a Object* value

VariantData (Object &val)

creates a VariantData initialized by a Object& value

VariantData (const Object &val)

creates a VariantData initialized by a const Object& value

VariantData (Interface *val)

creates a VariantData initialized by a Interface* value

VariantData (const VCF::int64 &val)

creates a Variant initialized by a int64 value

VariantData (const VCF::uint64 &val)

creates a Variant initialized by a uint64 value

VariantData (const DateTime &val)

creates a Variant initialized by a DateTime value

VariantData (const DateTimeSpan &val)

creates a Variant initialized by a DateTimeSpan value

VariantData (const VariantData &value)

copy constructor

~VariantData ()

destructor

bool operator== (const VariantData &v) const

comparison operator

bool operator!= (const VariantData &v) const

comparison operator

operator int () const

converts the VariantData to an int

operator long () const

converts the VariantData to an long

operator short () const

converts the VariantData to an short

operator ushort () const

converts the VariantData to an unsigned short

operator unsigned int () const

converts the VariantData to an unsigned int

operator unsigned long () const

converts the VariantData to an unsigned long

operator float () const

converts the VariantData to an float

operator char () const

converts the VariantData to an char

operator double () const

converts the VariantData to an double

operator Interface * () const

converts the VariantData to an Interface pointer

operator Object * () const

converts the VariantData to an Object pointer

operator Object & () const

converts the VariantData to an Object reference

operator String () const

converts the VariantData to an String

operator bool () const

converts the VariantData to a bool

operator Enum * () const

converts the VariantData to an Enum pointer

operator Enum & () const

converts the VariantData to an Enum reference

operator VCF::int64 () const

converts the Variant to a int64

operator VCF::uint64 () const

converts the Variant to an uint64

operator VCF::DateTime () const

converts the Variant to a DateTime

operator VCF::DateTimeSpan () const

converts the Variant to a DateTimeSpan

VariantData & operator= (const VariantData &newValue)

VariantData & operator= (VariantData *newValue)

VariantData & operator= (const int &newValue)

Assigns an int value to the VariantData.

VariantData & operator= (const long &newValue)

Assigns an long value to the VariantData.

VariantData & operator= (const short &newValue)

Assigns an short value to the VariantData.

VariantData & operator= (const ushort &newValue)

Assigns an unsigned short value to the VariantData.

VariantData & operator= (const unsigned int &newValue)

Assigns an unsigned int value to the VariantData.

VariantData & operator= (const unsigned long &newValue)

Assigns an unsigned long value to the VariantData.

VariantData & operator= (const float &newValue)

Assigns an float value to the VariantData.

VariantData & operator= (const char &newValue)

Assigns an char value to the VariantData.

VariantData & operator= (const double &newValue)

Assigns an double value to the VariantData.

VariantData & operator= (const bool &newValue)

Assigns an bool value to the VariantData.

VariantData & operator= (const char *newValue)

Assigns an string (as an array of char's) to the VariantData.

VariantData & operator= (Interface *newValue)

Assigns an Interface pointer to the VariantData.

VariantData & operator= (Object *newValue)

Assigns an Object pointer to the VariantData.

VariantData & operator= (const Object &newValue)

Assigns an Object reference to the VariantData.

VariantData & operator= (const String &newValue)

Assigns an string (as an String) to the VariantData.

VariantData & operator= (Enum *newValue)

Assigns an Enum pointer to the VariantData.

VariantData & operator= (const Enum &newValue)

Assigns an Enum reference to the VariantData.

VariantData & operator= (const int64 &newValue)

Assigns a int64 value to the Variant.

VariantData & operator= (const uint64 &newValue)

Assigns an uint64 value to the Variant.

VariantData & operator= (const DateTime &newValue)

Assigns a DateTime value to the Variant.

VariantData & operator= (const DateTimeSpan &newValue)

Assigns a DateTimeSpan value to the Variant.

bool isNull () const

Returns true or false depending on whether the variant is considered "null".

void setNull ()

Mark the variant as "null" and set it's internal values to NULL (or 0).

String toString () const

converts the VariantData to a string, no matter what the type.

void setFromString (const String &value)

Assigns the VariantData's data from a string.

void checkStringVal ()

Static Public Member Functions

static VariantData null ()

Public Attributes

String * StringVal

string are a special case

PropertyDescriptorType type

defines the data type of the VariantData, where type can represent an int, unsigned int, long, unsigned long, short, char, double, float, bool, string, Enum pointer, Object pointer, int64, uint64, DateTime or DateTimeSpan.

int IntVal

long LongVal

short ShortVal

ushort UShortVal

unsigned int UIntVal

unsigned long ULongVal

float FloatVal

char CharVal

double DblVal

bool BoolVal

Object * ObjVal

EnumValue EnumVal

Interface * InterfaceVal

int64 Int64Val

uint64 UInt64Val

Protected Member Functions

void setValue (const VariantData &value)

Detailed Description

VariantData represents an unknown type of variable - similiar to Visual Basic's Variant object.

VariantData objects can store int, long, double, bool String, or Object*. VariantData overrides conversion operators and provides operator equals overloads to handle the conversion from one type to another. Setting the value of a VariantData automatically sets the type. For example:

    VariantData val;
    int i = 123;
    val = i; //automatically sets the VariantData::type to equal pdInt

To convert from one type to another is equally simple:

    VariantData val;
    int i;
    double d;
    val = 234.8546; //val is 234.8546 and is set to the correct type
    d = val; //val is converted to a double and d is assigned the value 234.8546
    val = 123; //val is now assigned an int (or whatever the compiler assumes 123 is )
    i = val;    //i is now equal to 123

Strings are a special case, since the compiler will not allow a union to be made with them, thus the reason for the StringVal member outside of the union. VariantData objects can also have their data render as a string and can be assigned strings and convert then to the correct data value.

Version:: 1.0

Author:: Jim Crafton

Member Enumeration Documentation

anonymous enum

Enumerator:

DefaultPropertyValLength

Constructor & Destructor Documentation

VCF::VariantData::VariantData ( ) [inline]

creates an empty, undefined object

VCF::VariantData::VariantData ( const int & val ) [inline]

creates a VariantData initialized by an int value

VCF::VariantData::VariantData ( const unsigned int & val ) [inline]

creates a VariantData initialized by an unsigned int value

VCF::VariantData::VariantData ( const long & val ) [inline]

creates a VariantData initialized by a long value

VCF::VariantData::VariantData ( const unsigned long & val ) [inline]

creates a VariantData initialized by an unsigned long value

VCF::VariantData::VariantData ( const float & val ) [inline]

creates a VariantData initialized by a float value

VCF::VariantData::VariantData ( const double & val ) [inline]

creates a VariantData initialized by a double value

VCF::VariantData::VariantData ( const char & val ) [inline]

creates a VariantData initialized by a char value

VCF::VariantData::VariantData ( const bool & val ) [inline]

creates a VariantData initialized by a bool value

VCF::VariantData::VariantData ( const short & val ) [inline]

creates a VariantData initialized by a short value

VCF::VariantData::VariantData ( const ushort & val ) [inline]

creates a VariantData initialized by a short value

VCF::VariantData::VariantData ( const String & val ) [inline]

creates a VariantData initialized by a String value

VCF::VariantData::VariantData ( const char * val ) [inline]

VCF::VariantData::VariantData ( const WideChar * val ) [inline]

VCF::VariantData::VariantData ( const Enum & val ) [inline]

creates a VariantData initialized by a Enum value

VCF::VariantData::VariantData ( Enum & val ) [inline]

creates a VariantData initialized by a Enum value

VCF::VariantData::VariantData ( Enum * val ) [inline]

creates a VariantData initialized by a Enum* value

VCF::VariantData::VariantData ( Object * val ) [inline]

creates a VariantData initialized by a Object* value

VCF::VariantData::VariantData ( Object & val ) [inline]

creates a VariantData initialized by a Object& value

VCF::VariantData::VariantData ( const Object & val ) [inline]

creates a VariantData initialized by a const Object& value

VCF::VariantData::VariantData ( Interface * val ) [inline]

creates a VariantData initialized by a Interface* value

VCF::VariantData::VariantData ( const VCF::int64 & val ) [inline]

creates a Variant initialized by a int64 value

VCF::VariantData::VariantData ( const VCF::uint64 & val ) [inline]

creates a Variant initialized by a uint64 value

VCF::VariantData::VariantData ( const DateTime & val ) [inline]

creates a Variant initialized by a DateTime value

VCF::VariantData::VariantData ( const DateTimeSpan & val ) [inline]

creates a Variant initialized by a DateTimeSpan value

VCF::VariantData::VariantData ( const VariantData & value ) [inline]

copy constructor

VCF::VariantData::~VariantData ( ) [inline]

destructor

Member Function Documentation

void VCF::VariantData::checkStringVal ( ) [inline]

bool VCF::VariantData::isNull ( ) const [inline]

Returns true or false depending on whether the variant is considered "null".
If the type value is equal to pdNull, then the variant is considered null and any values it may or may not contain should be ignored.

static VariantData VCF::VariantData::null ( ) [inline, static]

VCF::VariantData::operator bool ( ) const [inline]

converts the VariantData to a bool

VCF::VariantData::operator char ( ) const [inline]

converts the VariantData to an char

VCF::VariantData::operator double ( ) const [inline]

converts the VariantData to an double

VCF::VariantData::operator Enum & ( ) const [inline]

converts the VariantData to an Enum reference

VCF::VariantData::operator Enum * ( ) const [inline]

converts the VariantData to an Enum pointer

VCF::VariantData::operator float ( ) const [inline]

converts the VariantData to an float

VCF::VariantData::operator int ( ) const [inline]

converts the VariantData to an int

VCF::VariantData::operator Interface * ( ) const [inline]

converts the VariantData to an Interface pointer

VCF::VariantData::operator long ( ) const [inline]

converts the VariantData to an long

VCF::VariantData::operator Object & ( ) const [inline]

converts the VariantData to an Object reference

VCF::VariantData::operator Object * ( ) const [inline]

converts the VariantData to an Object pointer

VCF::VariantData::operator short ( ) const [inline]

converts the VariantData to an short

VCF::VariantData::operator String ( ) const [inline]

converts the VariantData to an String

VCF::VariantData::operator unsigned int ( ) const [inline]

converts the VariantData to an unsigned int

VCF::VariantData::operator unsigned long ( ) const [inline]

converts the VariantData to an unsigned long

VCF::VariantData::operator ushort ( ) const [inline]

converts the VariantData to an unsigned short

VCF::VariantData::operator VCF::DateTime ( ) const [inline]

converts the Variant to a DateTime

VCF::VariantData::operator VCF::DateTimeSpan ( ) const [inline]

converts the Variant to a DateTimeSpan

VCF::VariantData::operator VCF::int64 ( ) const [inline]

converts the Variant to a int64

VCF::VariantData::operator VCF::uint64 ( ) const [inline]

converts the Variant to an uint64

bool VCF::VariantData::operator!= ( const VariantData & v ) const [inline]

comparison operator

VariantData& VCF::VariantData::operator= ( const DateTimeSpan & newValue ) [inline]

Assigns a DateTimeSpan value to the Variant.

VariantData& VCF::VariantData::operator= ( const DateTime & newValue ) [inline]

Assigns a DateTime value to the Variant.

VariantData& VCF::VariantData::operator= ( const uint64 & newValue ) [inline]

Assigns an uint64 value to the Variant.

VariantData& VCF::VariantData::operator= ( const int64 & newValue ) [inline]

Assigns a int64 value to the Variant.

VariantData& VCF::VariantData::operator= ( const Enum & newValue ) [inline]

Assigns an Enum reference to the VariantData.

VariantData& VCF::VariantData::operator= ( Enum * newValue ) [inline]

Assigns an Enum pointer to the VariantData.

VariantData& VCF::VariantData::operator= ( const String & newValue ) [inline]

Assigns an string (as an String) to the VariantData.

VariantData& VCF::VariantData::operator= ( const Object & newValue ) [inline]

Assigns an Object reference to the VariantData.

VariantData& VCF::VariantData::operator= ( Object * newValue ) [inline]

Assigns an Object pointer to the VariantData.

VariantData& VCF::VariantData::operator= ( Interface * newValue ) [inline]

Assigns an Interface pointer to the VariantData.

VariantData& VCF::VariantData::operator= ( const char * newValue ) [inline]

Assigns an string (as an array of char's) to the VariantData.

VariantData& VCF::VariantData::operator= ( const bool & newValue ) [inline]

Assigns an bool value to the VariantData.

VariantData& VCF::VariantData::operator= ( const double & newValue ) [inline]

Assigns an double value to the VariantData.

VariantData& VCF::VariantData::operator= ( const char & newValue ) [inline]

Assigns an char value to the VariantData.

VariantData& VCF::VariantData::operator= ( const float & newValue ) [inline]

Assigns an float value to the VariantData.

VariantData& VCF::VariantData::operator= ( const unsigned long & newValue ) [inline]

Assigns an unsigned long value to the VariantData.

VariantData& VCF::VariantData::operator= ( const unsigned int & newValue ) [inline]

Assigns an unsigned int value to the VariantData.

VariantData& VCF::VariantData::operator= ( const ushort & newValue ) [inline]

Assigns an unsigned short value to the VariantData.

VariantData& VCF::VariantData::operator= ( const short & newValue ) [inline]

Assigns an short value to the VariantData.

VariantData& VCF::VariantData::operator= ( const long & newValue ) [inline]

Assigns an long value to the VariantData.

VariantData& VCF::VariantData::operator= ( const int & newValue ) [inline]

Assigns an int value to the VariantData.

VariantData& VCF::VariantData::operator= ( VariantData * newValue ) [inline]

VariantData& VCF::VariantData::operator= ( const VariantData & newValue ) [inline]

bool VCF::VariantData::operator== ( const VariantData & v ) const [inline]

comparison operator

void VCF::VariantData::setFromString ( const String & value )

Assigns the VariantData's data from a string.
The conversion process is dependent on the type of the VariantData.

void VCF::VariantData::setNull ( ) [inline]

Mark the variant as "null" and set it's internal values to NULL (or 0).

void VCF::VariantData::setValue ( const VariantData & value ) [protected]

String VCF::VariantData::toString ( ) const

converts the VariantData to a string, no matter what the type.
Object* are persisted to a TextOutputStream if they support Persistable, otherwise the Object's toString() method is invoked.

Member Data Documentation

bool VCF::VariantData::BoolVal

char VCF::VariantData::CharVal

double VCF::VariantData::DblVal

EnumValue VCF::VariantData::EnumVal

float VCF::VariantData::FloatVal

int64 VCF::VariantData::Int64Val

Interface* VCF::VariantData::InterfaceVal

int VCF::VariantData::IntVal

long VCF::VariantData::LongVal

Object* VCF::VariantData::ObjVal

short VCF::VariantData::ShortVal

String* VCF::VariantData::StringVal

string are a special case

PropertyDescriptorType VCF::VariantData::type

defines the data type of the VariantData, where type can represent an int, unsigned int, long, unsigned long, short, char, double, float, bool, string, Enum pointer, Object pointer, int64, uint64, DateTime or DateTimeSpan.

uint64 VCF::VariantData::UInt64Val

unsigned int VCF::VariantData::UIntVal

unsigned long VCF::VariantData::ULongVal

ushort VCF::VariantData::UShortVal

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

vcf/FoundationKit/VariantData.h


Public Types
enum	{ DefaultPropertyValLength = 50 }
Public Member Functions
	VariantData ()
	creates an empty, undefined object
	VariantData (const int &val)
	creates a VariantData initialized by an int value
	VariantData (const unsigned int &val)
	creates a VariantData initialized by an unsigned int value
	VariantData (const long &val)
	creates a VariantData initialized by a long value
	VariantData (const unsigned long &val)
	creates a VariantData initialized by an unsigned long value
	VariantData (const float &val)
	creates a VariantData initialized by a float value
	VariantData (const double &val)
	creates a VariantData initialized by a double value
	VariantData (const char &val)
	creates a VariantData initialized by a char value
	VariantData (const bool &val)
	creates a VariantData initialized by a bool value
	VariantData (const short &val)
	creates a VariantData initialized by a short value
	VariantData (const ushort &val)
	creates a VariantData initialized by a short value
	VariantData (const String &val)
	creates a VariantData initialized by a String value
	VariantData (const char *val)
	VariantData (const WideChar *val)
	VariantData (const Enum &val)
	creates a VariantData initialized by a Enum value
	VariantData (Enum &val)
	creates a VariantData initialized by a Enum value
	VariantData (Enum *val)
	creates a VariantData initialized by a Enum* value
	VariantData (Object *val)
	creates a VariantData initialized by a Object* value
	VariantData (Object &val)
	creates a VariantData initialized by a Object& value
	VariantData (const Object &val)
	creates a VariantData initialized by a const Object& value
	VariantData (Interface *val)
	creates a VariantData initialized by a Interface* value
	VariantData (const VCF::int64 &val)
	creates a Variant initialized by a int64 value
	VariantData (const VCF::uint64 &val)
	creates a Variant initialized by a uint64 value
	VariantData (const DateTime &val)
	creates a Variant initialized by a DateTime value
	VariantData (const DateTimeSpan &val)
	creates a Variant initialized by a DateTimeSpan value
	VariantData (const VariantData &value)
	copy constructor
	~VariantData ()
	destructor
bool	operator== (const VariantData &v) const
	comparison operator
bool	operator!= (const VariantData &v) const
	comparison operator
	operator int () const
	converts the VariantData to an int
	operator long () const
	converts the VariantData to an long
	operator short () const
	converts the VariantData to an short
	operator ushort () const
	converts the VariantData to an unsigned short
	operator unsigned int () const
	converts the VariantData to an unsigned int
	operator unsigned long () const
	converts the VariantData to an unsigned long
	operator float () const
	converts the VariantData to an float
	operator char () const
	converts the VariantData to an char
	operator double () const
	converts the VariantData to an double
	operator Interface * () const
	converts the VariantData to an Interface pointer
	operator Object * () const
	converts the VariantData to an Object pointer
	operator Object & () const
	converts the VariantData to an Object reference
	operator String () const
	converts the VariantData to an String
	operator bool () const
	converts the VariantData to a bool
	operator Enum * () const
	converts the VariantData to an Enum pointer
	operator Enum & () const
	converts the VariantData to an Enum reference
	operator VCF::int64 () const
	converts the Variant to a int64
	operator VCF::uint64 () const
	converts the Variant to an uint64
	operator VCF::DateTime () const
	converts the Variant to a DateTime
	operator VCF::DateTimeSpan () const
	converts the Variant to a DateTimeSpan
VariantData &	operator= (const VariantData &newValue)
VariantData &	operator= (VariantData *newValue)
VariantData &	operator= (const int &newValue)
	Assigns an int value to the VariantData.
VariantData &	operator= (const long &newValue)
	Assigns an long value to the VariantData.
VariantData &	operator= (const short &newValue)
	Assigns an short value to the VariantData.
VariantData &	operator= (const ushort &newValue)
	Assigns an unsigned short value to the VariantData.
VariantData &	operator= (const unsigned int &newValue)
	Assigns an unsigned int value to the VariantData.
VariantData &	operator= (const unsigned long &newValue)
	Assigns an unsigned long value to the VariantData.
VariantData &	operator= (const float &newValue)
	Assigns an float value to the VariantData.
VariantData &	operator= (const char &newValue)
	Assigns an char value to the VariantData.
VariantData &	operator= (const double &newValue)
	Assigns an double value to the VariantData.
VariantData &	operator= (const bool &newValue)
	Assigns an bool value to the VariantData.
VariantData &	operator= (const char *newValue)
	Assigns an string (as an array of char's) to the VariantData.
VariantData &	operator= (Interface *newValue)
	Assigns an Interface pointer to the VariantData.
VariantData &	operator= (Object *newValue)
	Assigns an Object pointer to the VariantData.
VariantData &	operator= (const Object &newValue)
	Assigns an Object reference to the VariantData.
VariantData &	operator= (const String &newValue)
	Assigns an string (as an String) to the VariantData.
VariantData &	operator= (Enum *newValue)
	Assigns an Enum pointer to the VariantData.
VariantData &	operator= (const Enum &newValue)
	Assigns an Enum reference to the VariantData.
VariantData &	operator= (const int64 &newValue)
	Assigns a int64 value to the Variant.
VariantData &	operator= (const uint64 &newValue)
	Assigns an uint64 value to the Variant.
VariantData &	operator= (const DateTime &newValue)
	Assigns a DateTime value to the Variant.
VariantData &	operator= (const DateTimeSpan &newValue)
	Assigns a DateTimeSpan value to the Variant.
bool	isNull () const
	Returns true or false depending on whether the variant is considered "null".
void	setNull ()
	Mark the variant as "null" and set it's internal values to NULL (or 0).
String	toString () const
	converts the VariantData to a string, no matter what the type.
void	setFromString (const String &value)
	Assigns the VariantData's data from a string.
void	checkStringVal ()
Static Public Member Functions
static VariantData	null ()
Public Attributes
String *	StringVal
	string are a special case
PropertyDescriptorType	type
	defines the data type of the VariantData, where type can represent an int, unsigned int, long, unsigned long, short, char, double, float, bool, string, Enum pointer, Object pointer, int64, uint64, DateTime or DateTimeSpan.
int	IntVal
long	LongVal
short	ShortVal
ushort	UShortVal
unsigned int	UIntVal
unsigned long	ULongVal
float	FloatVal
char	CharVal
double	DblVal
bool	BoolVal
Object *	ObjVal
EnumValue	EnumVal
Interface *	InterfaceVal
int64	Int64Val
uint64	UInt64Val
Protected Member Functions
void	setValue (const VariantData &value)