OnixS Xetra MDI Market Data Handler for C++  1.0.0.0
Public Member Functions | Friends | List of all members
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.
 
FieldValueRefoperator= (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.

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.