FieldValueRef Class Reference

Implements concept of a read-only reference to a FIX field value. More...

Public Member Functions
	FieldValueRef ()
	Uninitialized value.
	FieldValueRef (const FieldValueRef &other)
	Shallow copy from another one.
	operator bool () const
	Indicated whether the instance refers to a valid value. More...
	operator std::string () const
	Return string presentation of the value being referenced. More...
bool	operator== (const FieldValueRef &) const
	Compares with another instance for equality.
bool	operator!= (const FieldValueRef &) const
	Compares with another instance for inequality.
bool	operator== (const StringRef &) const
	Compares string presentation for equality with given text reference. More...
bool	operator!= (const StringRef &) const
	Compares string presentation for equality with given text reference. More...
bool	toNumber (Int32 &) const
	Converts field value into whole number. More...
bool	toNumber (UInt32 &) const
	Converts field value into whole number. More...
bool	toNumber (Int64 &) const
	Converts field value into whole number. More...
bool	toNumber (UInt64 &) const
	Converts field value into whole number. More...
bool	toNumber (Decimal &) const
	Converts field value into floating point value. More...
bool	toTimestamp (Timestamp &, TimestampFormat::Enum=TimestampFormat::YYYYMMDDHHMMSSNsec) const
	Converts field value into timestamp of requested format. More...
bool	toStringRef (StringRef &) const
	If value represents text, returns reference to it. More...
bool	toChar (char &) const
	If value represent one-char text, copies it into given variable. More...
bool	toGroup (Group &) const
	If repeating group is associated with field, allows to get instance of it. More...
void	toString (std::string &) const
	Appends copy of text presentation to the std::string.
std::string	toString () const
	Return string presentation of field value.
FieldValueRef &	operator= (const FieldValueRef &)
	Updates instance to refer to another field value. More...

Friends
class	MessageOperator

Detailed Description

Implements concept of a read-only reference to a FIX field value.

Member Function Documentation

operator bool

(

)

const

Indicated whether the instance refers to a valid value.

operator std::string ( ) const

inline

Return string presentation of the value being referenced.

bool operator!=

(

const StringRef &

)

const

Compares string presentation for equality with given text reference.

FieldValueRef& operator=

(

const FieldValueRef &

)

Updates instance to refer to another field value.

Warning

Does NOT perform deep copy of field values. Just updates reference to point to value of other field.

bool operator==

(

const StringRef &

)

const

Compares string presentation for equality with given text reference.

bool toChar

(

char &

)

const

If value represent one-char text, copies it into given variable.

Returns

false if conversion fails (for example, stored value is whole number assigned to a field using OnixS::FIX::FieldSet::setV member).

Warning

Due to performance considerations doesn't check whether instance refers to a valid value. Use OnixS::FIX::FieldValueRef::operator bool() member to check instance for a validness.

bool toGroup

(

Group &

)

const

If repeating group is associated with field, allows to get instance of it.

Returns

false if no group is associated with field.

Warning

Due to performance considerations doesn't check whether instance refers to a valid value. Use OnixS::FIX::FieldValueRef::operator bool() member to check instance for a validness.

bool toNumber

(

Int32 &

)

const

Converts field value into whole number.

Returns

false if conversion fails.

Warning

Due to performance considerations doesn't check whether instance refers to a valid value. Use OnixS::FIX::FieldValueRef::operator bool() member to check instance for a validness.

bool toNumber

(

UInt32 &

)

const

Converts field value into whole number.

Returns

false if conversion fails.

Warning

Due to performance considerations doesn't check whether instance refers to a valid value. Use OnixS::FIX::FieldValueRef::operator bool() member to check instance for a validness.

bool toNumber

(

Int64 &

)

const

Converts field value into whole number.

Returns

false if conversion fails.

Warning

Due to performance considerations doesn't check whether instance refers to a valid value. Use OnixS::FIX::FieldValueRef::operator bool() member to check instance for a validness.

bool toNumber

(

UInt64 &

)

const

Converts field value into whole number.

Returns

false if conversion fails.

Warning

Due to performance considerations doesn't check whether instance refers to a valid value. Use OnixS::FIX::FieldValueRef::operator bool() member to check instance for a validness.

bool toNumber

(

Decimal &

)

const

Converts field value into floating point value.

Returns

false if conversion fails.

Warning

Due to performance considerations doesn't check whether instance refers to a valid value. Use OnixS::FIX::FieldValueRef::operator bool() member to check instance for a validness.

bool toStringRef

(

StringRef &

)

const

If value represents text, returns reference to it.

Returns

false if conversion fails (for example, stored value is whole number assigned to a field using OnixS::FIX::FieldSet::setV member).

Warning

Due to performance considerations doesn't check whether instance refers to a valid value. Use OnixS::FIX::FieldValueRef::operator bool() member to check instance for a validness.

bool toTimestamp	(	Timestamp &	,
		TimestampFormat::Enum	= TimestampFormat::YYYYMMDDHHMMSSNsec
	)		const

Converts field value into timestamp of requested format.

Returns

false if conversion fails.

Warning

Due to performance considerations doesn't check whether instance refers to a valid value. Use OnixS::FIX::FieldValueRef::operator bool() member to check instance for a validness.