#include <props.hxx>
Inherited by SGRawValueFunctions, SGRawValueFunctionsIndexed, SGRawValueMethods, SGRawValueMethodsIndexed, and SGRawValuePointer.
When the property value is not managed internally in the SGPropertyNode, the SGPropertyNode will contain a reference to an SGRawValue (this class), which provides an abstract way to get, set, and clone the underlying value. The SGRawValue may change frequently during a session as a value is retyped or bound and unbound to various data source, but the abstract SGPropertyNode layer insulates the application from those changes. The raw value contains no facilities for data binding or for type conversion: it is simply the abstraction of a primitive data type (or a compound data type, in the case of a string).
The SGPropertyNode class always keeps a *copy* of a raw value, not the original one passed to it; if you override a derived class but do not replace the clone method, strange things will happen.
All derived SGRawValue classes must implement getValue, setValue, and clone for the appropriate type.
Definition at line 149 of file props.hxx.
Public Member Functions | |
| virtual SGRawValue * | clone () const =0 |
| Create a new deep copy of this raw value. | |
| virtual T | getValue () const =0 |
| Return the underlying value. | |
| virtual bool | setValue (T value)=0 |
| Assign a new underlying value. | |
| SGRawValue () | |
| Constructor. | |
| virtual | ~SGRawValue () |
| Destructor. | |
Static Public Attributes | |
| static const T | DefaultValue |
| The default underlying value for this type. | |
| SGRawValue | ( | ) | [inline] |
| virtual SGRawValue* clone | ( | ) | const [pure virtual] |
The copy will contain its own version of the underlying value as well.
Implemented in SGRawValuePointer, SGRawValueFunctions, SGRawValueFunctionsIndexed, SGRawValueMethods, and SGRawValueMethodsIndexed.
| virtual T getValue | ( | ) | const [pure virtual] |
Implemented in SGRawValuePointer, SGRawValueFunctions, SGRawValueFunctionsIndexed, SGRawValueMethods, and SGRawValueMethodsIndexed.
| virtual bool setValue | ( | T | value | ) | [pure virtual] |
If the new value cannot be set (because this is a read-only raw value, or because the new value is not acceptable for some reason) this method returns false and leaves the original value unchanged.
| value | The actual value for the property. |
Implemented in SGRawValuePointer, SGRawValueFunctions, SGRawValueFunctionsIndexed, SGRawValueMethods, and SGRawValueMethodsIndexed.
const T DefaultValue [static] |
Every raw value has a default; the default is false for a boolean, 0 for the various numeric values, and "" for a string. If additional types of raw values are added in the future, they may need different kinds of default values (such as epoch for a date type). The default value is used when creating new values.
1.5.5