VR-Forces 4.8 Class Documentation
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
List of all members | Public Member Functions | Static Public Member Functions | Protected Member Functions | Protected Attributes | Private Member Functions
DtRwPropertiesMap Class Reference

Acts as a map for properties. More...

Inheritance diagram for DtRwPropertiesMap:
Inheritance graph
[legend]

Public Member Functions

virtual const charreaderWriterType () const
 Used to supply a string type that this reader writer type is. More...
 
virtual const charxmlType () const
 
DtRwPropertiesMapoperator= (const DtRwPropertiesMap &)
 
virtual bool isSimilarProperty (const DtPropertyInterface *rhs, bool strict=true) const
 Returns true if the prototype and key are the same types. More...
 
bool operator== (const DtRwPropertiesMap &) const
 
Constructors
 DtRwPropertiesMap (const DtString &name, DtReaderWriterRegistry *parentRegistry=0)
 
 DtRwPropertiesMap (const DtString &name, const DtString &keyType, const DtPropertyInterface *prototype, DtReaderWriterRegistry *parentRegistry=0)
 
 DtRwPropertiesMap (const DtString &name, const DtRwPropertiesMap &orig, DtReaderWriterRegistry *parentRegistry=0)
 
virtual ~DtRwPropertiesMap ()
 
Find Functions

Finds the item with the specified key.

Will fail if the type of the key does not match the type of myKeyType. Returns a DtPropertyInterface pointer to this item. If the item cannot be found returns a null pointer.

* propertiesMap.findItem("Some Resource"));
* boost::optional<int> resourceCount = item->findPropertyValue<int>("Count");
*
virtual DtPropertyInterfacefindItem (const DtString &key)
 
virtual DtPropertyInterfacefindItem (int key)
 
virtual DtPropertyInterfacefindItem (double key)
 
virtual const DtPropertyInterfacefindItem (const DtString &key) const
 
virtual const DtPropertyInterfacefindItem (int key) const
 
virtual const DtPropertyInterfacefindItem (double key) const
 
template<typename ValueType >
boost::optional< ValueType > findItemValue (const DtString &key) const
 Finds the value of the item with the specified key. More...
 
template<typename ValueType >
boost::optional< ValueType > findItemValue (int key) const
 Finds the value of the item with the specified key. More...
 
template<typename ValueType >
boost::optional< ValueType > findItemValue (double key) const
 Finds the value of the item with the specified key. More...
 
Insertion Functions

Insertion functions for adding a new item to the map.

Will fail if the type of the key does not match the type of myKeyType or if the type of the item does not match the type of myPrototype. If an element with that key already exists, it will not be replaced. If the item is added, the map takes ownership of it. Returns a bool indicating whether the insertion took place.

* DtRwPropertyInt* newItem = new DtRwPropertyInt("", 4);
* bool wasAdded = propertiesMap.insert("Num Soldiers", newItem);
*
virtual bool insert (const DtString &key, DtPropertyInterface *item)
 
virtual bool insert (int key, DtPropertyInterface *item)
 
virtual bool insert (double key, DtPropertyInterface *item)
 
Addition Functions

Adds a new item to the map of the same type as myPrototype that has the specified key.

Returns this item so that it may be set by the caller. If the key is of the wrong type then nothing is added and the returned pointer will be null. If an item with this key already exists, then nothing is added and the returned pointer will be null.

* static_cast<DtRwPropertiesStructure*>(propertiesMap.add("Some Resource"));
* newItem->findAndSetPropertyValue<int>("Count", 4);
*
virtual DtPropertyInterfaceaddItem (const DtString &key)
 
virtual DtPropertyInterfaceaddItem (int key)
 
virtual DtPropertyInterfaceaddItem (double key)
 
Erase Functions

Erases the item with the specified key.

Returns true if the item was found and erased. May also erase using an iterator to the item, as implemented in DtRwPropertiesList.

* propertiesMap.erase("Num Soldiers");
*
virtual bool erase (const DtString &key)
 
virtual bool erase (int key)
 
virtual bool erase (double key)
 
operator[] overloads for common key types

These operator[] overloads allow you to access a map item by common key types.

If the item does not exist, a new one will be added of the same type as the prototype. These allow you to index by common basic key types without necessarily converting the key to a DtPropertyInterface to call findItem. If the key is of the wrong type an uninitialized copy of the prototype will be returned that is not part of the map, so care must be taken.

* boost::optional<int> val = propertiesMap["Num Soldiers"].propertyValue<int>();
* if (val)
* {
* int newVal = *val + 1;
* propertiesMap["Num Soldiers"].setPropertyValue<int>(4);
* }
*
DtPropertyInterfaceoperator[] (const DtString &key)
 
const DtPropertyInterfaceoperator[] (const DtString &key) const
 
DtPropertyInterfaceoperator[] (double key)
 
const DtPropertyInterfaceoperator[] (double key) const
 
DtPropertyInterfaceoperator[] (int key)
 
const DtPropertyInterfaceoperator[] (int key) const
 
virtual void setKeyType (const DtString &)
 Sets/gets the key type. More...
 
virtual const DtReaderWriterkeyType () const
 
virtual bool keyIsInt () const
 Returns the type of key. More...
 
virtual bool keyIsReal () const
 
virtual bool keyIsString () const
 
- Public Member Functions inherited from DtRwPropertiesList
virtual charencode (char *) const
 Encodes the variable bindings into the supplied buffer. More...
 
virtual const chardecode (const char *)
 Decodes the variable bindings from the specified buffer. More...
 
virtual bool isValidProperty (const DtPropertyInterface *) const
 Returns true if this is a valid property for the properties list. More...
 
virtual int count () const
 Returns the number of valid items in this list. More...
 
virtual void getSelf (DtlObjPtr args, const DtReaderWriter::SearchPaths &searchPaths=DtReaderWriter::SearchPaths(), const DtVariableBindingsList &variableBindings=nullVariableReference())
 Reads in items, using the factory to read the correct types. More...
 
virtual void writeSelf (std::string &fp, int indentLevel=0, bool writeUnspecified=false, const DtFilename &path=DtFilename::nullFilename())
 Writes out registry data, but includes the type strings when writing. More...
 
virtual void writeData (std::string &fp, int indentLevel=0, bool writeUnspecified=false, const DtFilename &path=DtFilename::nullFilename())
 
virtual void setPrototype (const DtPropertyInterface *)
 Sets the prototype for this list. Will be cloned and kept as part of this object. More...
 
virtual const DtPropertyInterfaceprototype () const
 Returns the prototype for this list. More...
 
virtual DtPropertyInterfaceclonePrototype (DtReaderWriterRegistry *parent=0)
 Returns a clone of the prototype that belongs to this list. More...
 
DtRwPropertiesListoperator= (const DtRwPropertiesList &)
 
virtual void getSize (int &size) const
 Gets the size, in bytes, of this item. More...
 
bool operator== (const DtRwPropertiesList &) const
 
virtual bool matchPrototype (const DtReaderWriter *) const
 
 DtRwPropertiesList (const DtString &name, DtReaderWriterRegistry *parentRegistry=0)
 
 DtRwPropertiesList (const DtString &name, const DtPropertyInterface *prototype, DtReaderWriterRegistry *parentRegistry=0)
 
 DtRwPropertiesList (const DtString &name, const DtRwPropertiesList &orig, DtReaderWriterRegistry *parentRegistry=0)
 
virtual ~DtRwPropertiesList ()
 
virtual bool addItem (DtPropertyInterface *item)
 
virtual DtPropertyInterfaceaddItem ()
 Adds a new item to the end of the list of the same type as myPrototype. More...
 
virtual void erase (DtPropertyInterface *item)
 
virtual void erase (iterator pos)
 Erases the item at the specified iterator position. More...
 
- Public Member Functions inherited from DtRwProperties
DtRwPropertiesoperator= (const DtRwProperties &orig)
 
virtual ~DtRwProperties ()
 
virtual unsigned size () const
 Returns the number of items in the list. More...
 
virtual bool addProperty (DtPropertyInterface *)
 Adds an existing property to this list. This class will then take ownership of the property. More...
 
virtual DtPropertyInterfacecreateProperty (DtlObjPtr args, DtReaderWriterRegistry *parentRegistry)
 Creates a property from the mtl stream. More...
 
virtual void copyVariables (const DtRwVariableBindings &other)
 Clones variables using the property factory. More...
 
virtual bool isReadonly () const
 
virtual int hlaAlignment () const
 The required byte alignment of this property when encoding to HLA. More...
 
virtual int requiredPadding (const char *buf, const DtPropertyInterface *field) const
 The number of padding bytes required before writing the given field to the buffer for HLA encoding. More...
 
virtual const charpropertyType () const
 Typically returns reader/writer type. More...
 
virtual DtString stringRep (const DtString &root="") const
 
virtual bool merge (const DtPropertyInterface &target, MergeFlags, const DtMergePath &path=DtMergePath(), const std::set< DtString > &ignore=std::set< DtString >())
 Takes the contents of the supplied properties and merges with the following rules if replace is false: 1) If the same named property of the same type (and prototype and key) exists regardless of what the contents are in this property, it is replaced with the contents of the target 2) If a property in the target does not exist in source, it is not merged in 3) All other items are kept in the source. More...
 
virtual DtRwProperties createFromPercentages (const DtRwProperties &percentages, const DtRwProperties &baseValues, const DtString &base="Base-")
 This will take the supplied list of variable percentages and create a new state properties list that is the percentage of the "Base" value multiplied by the supplied percentage. More...
 
virtual bool findRootAndVariable (const DtString &varName, DtReaderWriter *&root, DtReaderWriter *&variable) const
 In this structure find the variable matching the name and the root that contains the variable. More...
 
virtual DtSymbolString propertyName () const
 The name of this property. More...
 
virtual void setPropertyName (const DtString &propertyName)
 Sets name of this property. Should generally only be called when initially created. More...
 
virtual bool wasUpdatedSince (DtTime t) const
 Returns true if an update occurred since the specified time. More...
 
virtual void clearVariables ()
 Removes and deletes all variable items. More...
 
virtual void reset ()
 Clears all variables. More...
 
virtual void invalidateCache ()
 Invalidates the entire cache. More...
 
virtual void invalidateCacheForProperty (const DtString &propName)
 Invalidates the single cache entry for the given property name. More...
 
virtual bool setWritePrototypeHeader (bool)
 
virtual bool writePrototypeHeader () const
 
 DtRwProperties (const DtString &name, DtReaderWriterRegistry *parentRegistry=0)
 
 DtRwProperties (const DtString &name, const DtRwProperties &orig, DtReaderWriterRegistry *parentRegistry=0)
 
 DtRwProperties (const DtRwProperties &orig, DtReaderWriterRegistry *parentRegistry=0)
 
virtual const_iterator begin () const
 
virtual iterator begin ()
 
virtual const_iterator end () const
 
virtual iterator end ()
 
virtual const DtPropertyInterfacefindPropertyInterface (const DtString &propertyName) const
 
virtual DtPropertyInterfacefindPropertyInterface (const DtString &propertyName)
 
virtual bool removeProperty (const DtString &propertyName)
 
virtual bool removeProperty (const DtPropertyInterface *property)
 
virtual const DtReaderWriterfindPropertyRw (const DtString &propName) const
 Returns the ReaderWriter for the (first) property that matches the given property name. More...
 
virtual DtReaderWriterfindPropertyRw (const DtString &propName)
 
virtual DtReaderWriterreaderWriter ()
 
virtual const DtReaderWriterreaderWriter () const
 
virtual DtPropertyInterfaceproperty ()
 
virtual const DtPropertyInterfaceproperty () const
 
virtual bool isPublished () const
 Whether this property should be published. More...
 
virtual void setIsPublished (bool isPub)
 
virtual unsigned disRecordType () const
 If this property is published, which DIS record type should it use. More...
 
virtual void setDisRecordType (unsigned recType)
 
virtual void removeVariable (DtReaderWriter *)
 
virtual void removeVariable (const DtReaderWriter *)
 
- Public Member Functions inherited from DtRwVariableBindings
 DtRwVariableBindings (const DtString &name, DtReaderWriterRegistry *parentRegistry=0)
 
 DtRwVariableBindings (const DtString &name, const DtRwVariableBindings &orig, DtReaderWriterRegistry *parentRegistry=0, bool copyVariables=true)
 
 DtRwVariableBindings (const DtRwVariableBindings &orig, DtReaderWriterRegistry *parentRegistry=0, bool copyVariables=true)
 
DtRwVariableBindingsoperator= (const DtRwVariableBindings &orig)
 
virtual ~DtRwVariableBindings ()
 
template<typename RW_Type >
const RW_Type * findAndCastVariableBinding (const DtString &variableName) const
 
virtual DtReaderWriteraddVariableBinding (const DtSymbolString &name, const char *type)
 Adds new variable binding to registry. More...
 
virtual void addVariable (DtReaderWriter *)
 Adds a newly created DtReaderWriter variable to the registry. More...
 
virtual int getSize () const
 Returns the size of this item, in bytes, iterating over all types. More...
 
bool operator== (const DtRwVariableBindings &) const
 
bool operator!= (const DtRwVariableBindings &) const
 
virtual DtString prettyPrint () const
 Routine to return a human readable form of the reader/writer variable. More...
 
virtual void setVariableSubstitutions (const std::map< DtString, DtString > &)
 
virtual const std::map
< DtString, DtString > & 
variableSubstitutions () const
 
virtual void merge (const DtRwVariableBindings &)
 Will take the contents of the supplied variable bindings and merge in both the variables (ignoring ones that already exist) and the variable substitutions. More...
 
virtual const DtReaderWriterfindVariableBinding (const DtString &rwTypeString, const DtString &variableName, const std::map< DtString, DtString > &variableSubstitutions=std::map< DtString, DtString >()) const
 Looks for the specified name/type combination in the registry, and returns a pointer to that RW object if it is found. More...
 
virtual DtReaderWriterfindVariableBinding (const DtString &rwTypeString, const DtString &variableName, const std::map< DtString, DtString > &variableSubstitutions=std::map< DtString, DtString >())
 
virtual const DtReaderWriterfindVariableBinding (const DtString &variableName, const std::map< DtString, DtString > &variableSubstitutions=std::map< DtString, DtString >()) const
 Finds the variable with the given name regardless of type. More...
 
virtual DtReaderWriterfindVariableBinding (const DtString &variableName, const std::map< DtString, DtString > &variableSubstitutions=std::map< DtString, DtString >())
 
- Public Member Functions inherited from DtReaderWriter
 DtReaderWriter ()
 default constructor More...
 
 DtReaderWriter (const DtString &name, DtReaderWriterRegistry *parentRegistry=NULL, bool readonly=false)
 real constructor Setting the readonly flag prevents object from writing itself to the stream. More...
 
 DtReaderWriter (const DtSymbolString &name, DtReaderWriterRegistry *parentRegistry=NULL, bool readonly=false)
 
 DtReaderWriter (const DtString &name, const DtReaderWriter &orig, DtReaderWriterRegistry *parentRegistry=NULL)
 pseudo-copy constructor More...
 
 DtReaderWriter (const DtSymbolString &name, const DtReaderWriter &orig, DtReaderWriterRegistry *parentRegistry=NULL)
 
 DtReaderWriter (const DtReaderWriter &, DtReaderWriterRegistry *parentRegistry=NULL)
 copy constructor More...
 
const DtReaderWriteroperator= (const DtReaderWriter &orig)
 assignment operator More...
 
bool operator== (const DtReaderWriter &) const
 Equivalence operator. More...
 
bool operator!= (const DtReaderWriter &rhs)
 
virtual ~DtReaderWriter ()
 destructor More...
 
virtual void putSelf (std::string &fp, int indentLevel=0, bool writeUnspecified=false, const DtFilename &path=DtFilename::nullFilename())
 Top level call to write itself to file. More...
 
virtual void postPutSelf ()
 Called after either version of put self (file or environment). Default is no-op. More...
 
virtual void prePutSelf ()
 Called before either version of put self (file or environment). Default is no-op. More...
 
virtual void postGetSelf ()
 Called after either version of getSelf (mtl or environment). Default is no-op. More...
 
virtual void preGetSelf ()
 Called before either version of get self (file or environment). Default is no-op. More...
 
virtual DtSymbolString name () const
 Accessor for name of this readable/writable object. More...
 
virtual void addAlias (const DtSymbolString &alias)
 Add an alias as an alternative name for this object. More...
 
virtual void addAlias (const DtString &alias)
 
virtual bool hasAlias (const DtSymbolString &alias)
 
virtual const aliasContaineraliases () const
 
virtual void setReadonly (bool flag)
 Set read-only flag. More...
 
bool isReadonly () const
 
virtual int alignment () const
 For those items that are sent over the network via HLA, this will give the network alignment. More...
 
virtual bool variableIsBound () const
 
virtual void unbindVariable ()
 Sets the myVariableIsBound flag to false. More...
 
virtual void setName (const DtString &)
 Set the name of the object. More...
 
std::string debugText () const
 
virtual void bindVariables (DtVariableBindingsList variableBindings)
 Runs a variable binding pass on this reader writer and any of its children. More...
 
virtual std::list
< DtVariableNameType
unboundVariables () const
 
bool invalid () const
 
virtual bool hasChild (const DtReaderWriter *p) const
 Returns true if this variable has a child p in it's chain. More...
 
virtual bool hasVariableReference () const
 Returns true if this item or any item in the registry (recursive) is a variable reference. More...
 
virtual void bindLocalVariables (const DtVariableBindingsList &variableBindings)
 Checks to see if this RW object is a variable reference that can be bound using the provided bindings. More...
 
virtual void recordUpdateTime () const
 Can be implemented in subclasses to stamp the time when updated. More...
 
virtual bool changedSinceLastChecked ()
 Returns true if this objects value has changed since the last time this function was called. More...
 
virtual bool peekChangedSinceLastChecked () const
 Returns the value that changedSinceLastChecked would return but does not reset the internal flag. More...
 
virtual void setValueSpecified (bool specified, bool recurse=false)
 The specified flags are used for optional values. More...
 
virtual bool valueSpecified () const
 
virtual bool isVariableReference () const
 Specifies whether or not this reader writer is really a variable that is specified elsewhere. More...
 
virtual void setIsVariableReference (bool value)
 
virtual void clearAllVariableReferenceFlags ()
 Clears out all variable reference flags from all readerwriter items in registry recursively. More...
 
virtual DtSymbolString variableName () const
 The variable name, if this object is a variable reference. More...
 
virtual void setVariableName (const DtSymbolString variableName)
 
virtual const DtReaderWriterdefaultRWValue () const
 The default value to use if the reader/writer object is a variable and that variable is not specified. More...
 
virtual DtReaderWriterdefaultRWValue ()
 
virtual void setDefaultRWValue (DtReaderWriter *)
 Previous default value, if exists, will be removed and replaced with a clone of the supplied variable. More...
 
virtual bool checkAndSetDefaultRWValue (DtlObjPtr args, const DtReaderWriter::SearchPaths &searchPaths=SearchPaths(), const DtVariableBindingsList &variableBindings=nullVariableReference())
 Give the stream, if the stream contains a default value then set it here. More...
 
const DtReaderWriterRegistryregistry () const
 Collection of child DtReaderWriter nodes owned by this object. More...
 
DtReaderWriterRegistryregistry ()
 
virtual DtString toXml () const
 
virtual DtRwVariableBindingsgenerateVariableBindings () const
 Iterates over the registry (recursively) and returns a variable bindings object that contains all the variables that are contained in this read/writer class. More...
 
virtual bool toXml (const DtFilename &) const
 Writes contents of xml result to the given filename. More...
 
virtual bool fromXml (const DtString &)
 Restores object from given xml string. Returns true if valid. More...
 
virtual bool fromXmlFile (const DtFilename &)
 Restores object from given xml file. More...
 
virtual void putSelf (DtEnvironmentSP, DtEnvValueSP parent) const
 
virtual void putVariableReference (DtEnvironmentSP, DtEnvValueSP value) const
 Called when the item is a variable reference. More...
 
virtual void getSelf (const DtEnvironmentSP, const DtEnvValueSP root, const SearchPaths &searchPaths=SearchPaths(), const DtVariableBindingsList &bindings=DtVariableBindingsList())
 
virtual void getVariableReference (DtEnvironmentSP, DtEnvValueSP value)
 Called when the item is a variable reference. More...
 
- Public Member Functions inherited from DtPropertyInterface
virtual ~DtPropertyInterface ()
 
int getSize () const
 
virtual bool isPublishedArg (DtlObjPtr arg, unsigned &disVarRecType) const
 Tests whether the argument specified indicates this property should be published. More...
 
template<typename ValueType >
boost::optional< ValueType > propertyValue () const
 
template<typename ValueType >
bool setPropertyValue (ValueType val)
 Sets the value of this property. More...
 
template<typename SpecificPropType >
const SpecificPropType * findProperty (const DtString &propertyName) const
 
template<typename SpecificPropType >
SpecificPropType * findProperty (const DtString &propertyName)
 
template<typename ValueType >
boost::optional< ValueType > findPropertyValue (const DtString &propertyName) const
 
template<typename ValueType >
bool findAndSetPropertyValue (const DtString &propertyName, ValueType val)
 This is a convenience function that combines the functionality of findProperty and setPropertyValue to immediately set the value of the property with the given name, assuming it can be found within this property and its value can be converted from the specified type. More...
 
template<typename SpecificPropType >
SpecificPropType * addNewProperty (const DtString &propertyName)
 Adds a new property of the specified type and returns pointer to the new item. More...
 

Static Public Member Functions

static const chartheXmlType ()
 The type that is used when archiving to an XML stream. More...
 
- Static Public Member Functions inherited from DtRwPropertiesList
static const chartheXmlType ()
 The type that is used when archiving to an XML stream. More...
 
- Static Public Member Functions inherited from DtRwProperties
static
DtReaderWriterPropertyFactory
propertyFactory ()
 Returns the factory used to create properties. Types are by RW types. More...
 
static void cleanupPropertyFactory ()
 
static const DtRwPropertiesemptyProperties ()
 
static bool rollUpInteger (const DtReaderWriter *source, DtReaderWriter *destination, const DtMergePath &path)
 Adds integers. More...
 
static bool rollUpReal (const DtReaderWriter *source, DtReaderWriter *destination, const DtMergePath &path)
 Adds reals. More...
 
static bool rollUpString (const DtReaderWriter *source, DtReaderWriter *destination, const DtMergePath &path)
 Will not roll up if values are dissimilar. More...
 
static bool rollUpBoolean (const DtReaderWriter *source, DtReaderWriter *destination, const DtMergePath &path)
 Will not roll up if values are dissimilar. More...
 
- Static Public Member Functions inherited from DtRwVariableBindings
static DtRwVariableBindingscreateBinding (const std::list< DtReaderWriter::DtVariableNameType > &)
 Creates a new instance of this class and creates all elements found in the list and adds it to this variables registry. More...
 
- Static Public Member Functions inherited from DtReaderWriter
static void putIndent (std::string &fp, int indentLevel)
 
static const
DtVariableBindingsList
nullVariableReference ()
 
static void setPostGetSelfCallback (DtGetSelfCallbackFcn fcn, void *usrData)
 
static void setPrePutSelfCallback (DtPutSelfCallbackFcn fcn, void *usrData)
 
static void setPutIndent (bool)
 
static bool putIndent ()
 
static const chartheXmlType ()
 The type that is used when archiving to an XML stream. More...
 
static const DtFilename & appPath ()
 Gets the current working directory. More...
 
static void setFactoryCreatorFunction (DtReaderWriterFactoryCreatorFcn fcn)
 Sets the function to create the DtReaderWriterFactory. More...
 
static void createReaderWriterFactory ()
 
static void cleanupFactory ()
 
static DtReaderWriterFactoryfactory ()
 
static void setOutputStream (DtOutputStream *stream)
 
static DtOutputStream & outputStream ()
 
static DtReaderWritercreateFromXmlFile (const DtFilename &, bool createAsProperty=false)
 Given a filename, returns a newly created reader/writer object from the object found within. More...
 
static DtReaderWritercreateFromXml (const DtString &, bool createAsProperty=false)
 Given a xml string, returns a newly created reader/writer object from the object found within. More...
 
static DtReaderWritercreateFromEnvironment (DtEnvironmentSP, bool createAsProperty=false)
 Given a xml environment, returns a newly created reader/writer object from the object found within. More...
 
static DtString getAttribute (DtEnvironmentSP env, const DtString &name, DtEnvValueSP root)
 Gets the named attribute from a DtEnvValueSP. More...
 

Protected Member Functions

virtual bool convertKeyToString (int key, DtString &str) const
 Convert the given int key to a DtString. If not possible, returns false. More...
 
virtual bool convertKeyToString (double key, DtString &str) const
 Convert the given double key to a DtString. If not possible, returns false. More...
 
virtual bool convertStringToKey (const DtString &str, int &key) const
 Convert the given DtString to an int key. If not possible, returns false. More...
 
virtual bool convertStringToKey (const DtString &str, double &key) const
 Convert the given DtString to a double key. If not possible, returns false. More...
 
virtual DtPropertyInterfacecreatePrototype (DtlObjPtr args)
 Get the key type before processing the rest of the items. More...
 
virtual DtlObjPtr variablesStart (DtlObjPtr args) const
 
virtual int hlaAlignment (const DtPropertyInterface *field) const
 Need to add in padding for key. More...
 
virtual void getSize (const DtPropertyInterface *, int &size) const
 Returns the size, in bytes, of the readerWriter item plus the key. More...
 
virtual void createListEntry (DtPropertyInterface *iFace, DtlObjPtr variableItem, const DtReaderWriter::SearchPaths &searchPaths, const DtVariableBindingsList &variableBindings)
 
virtual charencode (const DtPropertyInterface *, char *buf) const
 
virtual const chardecode (DtPropertyInterface *iFace, const char *buf)
 Decodes the variable bindings from the specified buffer. More...
 
virtual void getData (const DtEnvironmentSP env, const DtEnvValueSP root, const DtReaderWriter::SearchPaths &searchPaths, const DtVariableBindingsList &varBindings)
 Gets data from the environment value. More...
 
virtual void putData (DtEnvironmentSP env, DtEnvValueSP value) const
 Override to add attributes of actual data. More...
 
virtual void postWriteItem (std::string &fp, DtReaderWriter *rw, int indentLevel)
 
virtual void preWriteItem (std::string &fp, DtReaderWriter *rw, int indentLevel)
 
virtual DtPropertyInterfacescratchItem () const
 
virtual const DtPropertyInterfacefindPropertyInterfaceByStringKey (const DtString &keyStr) const
 Finds an item's property interface by its string key. More...
 
virtual DtPropertyInterfacefindPropertyInterfaceByStringKey (const DtString &keyStr)
 
- Protected Member Functions inherited from DtRwPropertiesList
virtual void writePrototype (const DtReaderWriter *, std::string &fp, int indentLevel, bool writeHeader=true) const
 
virtual void bindToRwAsVariable (const DtReaderWriter *rw)
 Copies values from the specified DtReaderWriter. More...
 
virtual DtlObjPtr getData (DtlObjPtr variableList, const DtReaderWriter::SearchPaths &searchPaths, const DtVariableBindingsList &variableBindings)
 Override to allow a variable to be assigned to a property of derived type. More...
 
virtual void assignPrototypeToChildren ()
 
virtual void setPrototypeIntoTarget (const DtPropertyInterface *prototype, DtReaderWriter *target)
 
virtual bool matchPrototype (const DtReaderWriter *prototype, const DtReaderWriter *match) const
 
virtual void cloneAndAddProperty (const DtReaderWriter &rw)
 Clones the given RW and tries to add it to this list. More...
 
- Protected Member Functions inherited from DtRwProperties
virtual void filterIgnoredProperties (DtReaderWriter *rw, const std::set< DtString > &ignore)
 Filters out all properties that are in the ignore list by removing them from the registry and deleting them. More...
 
virtual void getInterface (DtPropertyInterface *pFace, DtlObjPtr args, const DtReaderWriter::SearchPaths &searchPaths=SearchPaths(), const DtVariableBindingsList &variableBindings=nullVariableReference())
 If this is called then this is rebuilding a structure for a prototype, so, only get the name... More...
 
virtual void putData (std::string &, int indentLevel=0)
 Deriving class overrides these to get/put class specific data. More...
 
virtual void unrecognizedItem (const DtEnvironmentSP env, const DtEnvValueSP root, const DtReaderWriter::SearchPaths &searchPaths, const DtVariableBindingsList &varBindings)
 Create property based on type and add to registry. More...
 
virtual bool traverseAndModifyPercentage (DtRwProperties &results, const DtRwProperties &baseValues, const DtReaderWriter *percentage, const DtString &base) const
 Walks the percentage value, matching reader/writer names until the percentage is found. More...
 
virtual void writePrototypeHeader (std::string &fp, const DtReaderWriter *rw, int indentLevel) const
 
virtual void writePropertyData (DtReaderWriter *rw, std::string &fp, int indentLevel, bool writeUnspecified, const DtFilename &path)
 Writes out the reader/writer property value (including default value and variable name) More...
 
- Protected Member Functions inherited from DtRwVariableBindings
virtual const DtReaderWriterinternalFindVariableBinding (const DtString &rwTypeString, const DtString &variableName, const std::map< DtString, DtString > &variableSubstitutions=std::map< DtString, DtString >()) const
 Actual find method such that the const and non-const versions can share the same code. More...
 
virtual bool keywordMatches (const DtSymbolString &lhs, const DtString &rhs, const std::map< DtString, DtString > &variableSubstitutions) const
 Check to see if there are any variable substitutions such that a variable named something has a map to another name and can match the right hand side. More...
 

Protected Attributes

DtPropertyInterfacemyKeyType
 
DtPropertyInterfacemyScratchItem
 
- Protected Attributes inherited from DtRwPropertiesList
DtPropertyInterfacemyPrototype
 
DtRwPropertyInt myCount
 
- Protected Attributes inherited from DtRwProperties
std::multimap< DtString,
DtReaderWriter * > 
myRwPropertyCache
 
tbb::spin_mutex * myCacheMutex
 
DtClock myClock
 
DtTime myLastTimeSizeChanged
 Stores the last time at which it was discovered that the size of the list changed. More...
 
int mySizeAtLastCheck
 Stores the number of items in the last at the last time it was discovered the size changed. More...
 
bool myIsPublished
 
unsigned myDisRecordType
 
bool myWritePrototypeHeader
 
DtPropertyInterfacemyPreviousParentProp
 
DtString myPreviousParentPropFullName
 
- Protected Attributes inherited from DtRwVariableBindings
std::map< DtString, DtStringmyVariableSubstitutions
 
- Protected Attributes inherited from DtReaderWriter
const DtSymbolString myName
 
DtReaderWriterRegistry myRegistry
 
DtReaderWriterRegistrymyParentRegistry
 
bool myValueSpecified
 
bool myReadOnlyFlag
 
bool myIsVariableReference
 
DtSymbolString myVariableName
 
bool myVariableIsBound
 
DtReaderWritermyDefaultValue
 
aliasContainer myAliases
 Container for the aliases which represent alternative names for the object. More...
 
bool myInvalid
 Set to true if there is a problem reading this item. More...
 
bool myChangedFlag
 Set to true when value changes Set to false when value checked with changedSinceLastChecked. More...
 

Private Member Functions

 DtRwPropertiesMap ()
 Not implemented. More...
 

Additional Inherited Members

- Public Types inherited from DtRwProperties
typedef DtPropertiesIterator iterator
 
typedef DtPropertiesConstIterator const_iterator
 
- Public Types inherited from DtReaderWriter
typedef std::vector
< DtSymbolString
aliasContainer
 
typedef std::vector
< DtSymbolString >::iterator 
aliasIter
 
typedef std::vector
< DtSymbolString >
::const_iterator 
aliasConstIter
 
typedef std::vector< DtFilename > SearchPaths
 
typedef std::pair
< DtSymbolString, DtString
DtVariableNameType
 
typedef DtReaderWriterFactory *(* DtReaderWriterFactoryCreatorFcn )()
 
- Public Types inherited from DtPropertyInterface
enum  MergeFlags {
  Replace = 0x00000001, MinimalSimilarityCheck = 0x00000002, RollUp = 0x00000004, AddMissing = 0x00000008,
  KeepIsPublished = 0x00000010
}
 Determines how two lists of properties will be merged by the merge function. More...
 
- Static Protected Attributes inherited from DtRwProperties
static
DtReaderWriterPropertyFactory
thePropertyFactory
 
- Static Protected Attributes inherited from DtReaderWriter
static DtString theUnspecifiedValue
 
static DtGetSelfCallbackInfo thePostGetSelfCallback
 
static DtPutSelfCallbackInfo thePrePutSelfCallback
 
static const DtVariableBindingsList theEmptyVariableBindingsList
 
static bool theCreatorFcnSet
 
static DtReaderWriterFactorytheFactory
 
static
DtReaderWriterFactoryCreatorFcn 
theFactoryCreatorFcn
 
static bool thePutIndent
 
static DtOutputStream * theOutputStream
 

Detailed Description

Acts as a map for properties.

A map is a definition that has a key and a prototype, with values being the key and prototype pair. The key can only be a string (DtRwStringType), int (DtRwIntType, DtRwInt8Type, DtRwInt16Type, DtRwInt32Type), or real (DtRwRealType, DtRwReal32Type, DtRwReal64Type).

The map is defined in reader/writer as:

* (DtRwMap CombatList DtRwString
* (DtRwStruct CombatRange
* (DtRwReal Range)
* (DtRwInt Number)
* )
* ("Small" (100.0 20)) ("Medium" (200.0 40)) ("Large" (300.0 60))
* )
*
* For a single variable (not a structure) the map would look like:
* (DtRwMap Hit-List DtRwString
* ("Row 1" (1.0 2.0 3.0 4.0))
* )
*

As a subclass of DtRwProperties, DtRwPropertiesMap supports an STL-like iterator for iterating over its items. It also has convenience functions for adding, removing, and accessing items within the map by key. These include [] operators. Please also see DtRwPropertiesList for further convenience functions. The key type for a DtRwPropertiesMap must be a recognized simple property type (generally some type of integer, real, or string).

Constructor & Destructor Documentation

DtRwPropertiesMap::DtRwPropertiesMap ( )
private

Not implemented.

DtRwPropertiesMap::DtRwPropertiesMap ( const DtString name,
DtReaderWriterRegistry parentRegistry = 0 
)
DtRwPropertiesMap::DtRwPropertiesMap ( const DtString name,
const DtString keyType,
const DtPropertyInterface prototype,
DtReaderWriterRegistry parentRegistry = 0 
)
DtRwPropertiesMap::DtRwPropertiesMap ( const DtString name,
const DtRwPropertiesMap orig,
DtReaderWriterRegistry parentRegistry = 0 
)
virtual DtRwPropertiesMap::~DtRwPropertiesMap ( )
virtual

Member Function Documentation

virtual DtPropertyInterface* DtRwPropertiesMap::findItem ( const DtString key)
virtual
virtual DtPropertyInterface* DtRwPropertiesMap::findItem ( int  key)
virtual

virtual DtPropertyInterface* DtRwPropertiesMap::findItem ( double  key)
virtual

virtual const DtPropertyInterface* DtRwPropertiesMap::findItem ( const DtString key) const
virtual

This version returns a const pointer.

virtual const DtPropertyInterface* DtRwPropertiesMap::findItem ( int  key) const
virtual

virtual const DtPropertyInterface* DtRwPropertiesMap::findItem ( double  key) const
virtual

template<typename ValueType >
boost::optional< ValueType > DtRwPropertiesMap::findItemValue ( const DtString key) const

Finds the value of the item with the specified key.

Will fail if the type of the key does not match the type of myKeyType. Returns a boost::optional to the value of this item. If the item is not found or the value cannot be converted to the specified type, the boost::optional will be false.

* boost::optional<int> numSoldiers = propertiesMap.findItemValue<int>("Num Soldiers");
*

References keyIsString().

template<typename ValueType >
boost::optional< ValueType > DtRwPropertiesMap::findItemValue ( int  key) const

Finds the value of the item with the specified key.

Will fail if the type of the key does not match the type of myKeyType. Returns a boost::optional to the value of this item. If the item is not found or the value cannot be converted to the specified type, the boost::optional will be false.

* boost::optional<int> numSoldiers = propertiesMap.findItemValue<int>("Num Soldiers");
*

References convertKeyToString().

template<typename ValueType >
boost::optional< ValueType > DtRwPropertiesMap::findItemValue ( double  key) const

Finds the value of the item with the specified key.

Will fail if the type of the key does not match the type of myKeyType. Returns a boost::optional to the value of this item. If the item is not found or the value cannot be converted to the specified type, the boost::optional will be false.

* boost::optional<int> numSoldiers = propertiesMap.findItemValue<int>("Num Soldiers");
*

References convertKeyToString().

virtual bool DtRwPropertiesMap::insert ( const DtString key,
DtPropertyInterface item 
)
virtual
virtual bool DtRwPropertiesMap::insert ( int  key,
DtPropertyInterface item 
)
virtual
virtual bool DtRwPropertiesMap::insert ( double  key,
DtPropertyInterface item 
)
virtual
virtual DtPropertyInterface* DtRwPropertiesMap::addItem ( const DtString key)
virtual
virtual DtPropertyInterface* DtRwPropertiesMap::addItem ( int  key)
virtual
virtual DtPropertyInterface* DtRwPropertiesMap::addItem ( double  key)
virtual
virtual bool DtRwPropertiesMap::erase ( const DtString key)
virtual
virtual bool DtRwPropertiesMap::erase ( int  key)
virtual
virtual bool DtRwPropertiesMap::erase ( double  key)
virtual
DtPropertyInterface& DtRwPropertiesMap::operator[] ( const DtString key)
const DtPropertyInterface& DtRwPropertiesMap::operator[] ( const DtString key) const
DtPropertyInterface& DtRwPropertiesMap::operator[] ( double  key)
const DtPropertyInterface& DtRwPropertiesMap::operator[] ( double  key) const
DtPropertyInterface& DtRwPropertiesMap::operator[] ( int  key)
const DtPropertyInterface& DtRwPropertiesMap::operator[] ( int  key) const
virtual const char* DtRwPropertiesMap::readerWriterType ( ) const
virtual

Used to supply a string type that this reader writer type is.

This can be used in place of dynamic-casting. Also used by the opd editor to determine which type of control to create

Reimplemented from DtRwPropertiesList.

static const char* DtRwPropertiesMap::theXmlType ( )
static

The type that is used when archiving to an XML stream.

virtual const char* DtRwPropertiesMap::xmlType ( ) const
inlinevirtual

Reimplemented from DtRwPropertiesList.

References DtRwPropertiesList::theXmlType().

DtRwPropertiesMap& DtRwPropertiesMap::operator= ( const DtRwPropertiesMap )
virtual void DtRwPropertiesMap::setKeyType ( const DtString )
virtual

Sets/gets the key type.

virtual const DtReaderWriter* DtRwPropertiesMap::keyType ( ) const
virtual
virtual bool DtRwPropertiesMap::keyIsInt ( ) const
virtual

Returns the type of key.

virtual bool DtRwPropertiesMap::keyIsReal ( ) const
virtual
virtual bool DtRwPropertiesMap::keyIsString ( ) const
virtual

Referenced by findItemValue().

virtual bool DtRwPropertiesMap::isSimilarProperty ( const DtPropertyInterface rhs,
bool  strict = true 
) const
virtual

Returns true if the prototype and key are the same types.

Reimplemented from DtRwPropertiesList.

bool DtRwPropertiesMap::operator== ( const DtRwPropertiesMap ) const
virtual bool DtRwPropertiesMap::convertKeyToString ( int  key,
DtString str 
) const
protectedvirtual

Convert the given int key to a DtString. If not possible, returns false.

Referenced by findItemValue().

virtual bool DtRwPropertiesMap::convertKeyToString ( double  key,
DtString str 
) const
protectedvirtual

Convert the given double key to a DtString. If not possible, returns false.

virtual bool DtRwPropertiesMap::convertStringToKey ( const DtString str,
int key 
) const
protectedvirtual

Convert the given DtString to an int key. If not possible, returns false.

virtual bool DtRwPropertiesMap::convertStringToKey ( const DtString str,
double key 
) const
protectedvirtual

Convert the given DtString to a double key. If not possible, returns false.

virtual DtPropertyInterface* DtRwPropertiesMap::createPrototype ( DtlObjPtr  args)
protectedvirtual

Get the key type before processing the rest of the items.

Reimplemented from DtRwPropertiesList.

virtual DtlObjPtr DtRwPropertiesMap::variablesStart ( DtlObjPtr  args) const
protectedvirtual

Reimplemented from DtRwPropertiesList.

virtual int DtRwPropertiesMap::hlaAlignment ( const DtPropertyInterface field) const
protectedvirtual

Need to add in padding for key.

Reimplemented from DtRwPropertiesList.

virtual void DtRwPropertiesMap::getSize ( const DtPropertyInterface ,
int size 
) const
protectedvirtual

Returns the size, in bytes, of the readerWriter item plus the key.

Reimplemented from DtRwProperties.

virtual void DtRwPropertiesMap::createListEntry ( DtPropertyInterface iFace,
DtlObjPtr  variableItem,
const DtReaderWriter::SearchPaths searchPaths,
const DtVariableBindingsList variableBindings 
)
protectedvirtual

Reimplemented from DtRwPropertiesList.

virtual char* DtRwPropertiesMap::encode ( const DtPropertyInterface ,
char buf 
) const
protectedvirtual

Reimplemented from DtRwProperties.

virtual const char* DtRwPropertiesMap::decode ( DtPropertyInterface ,
const char  
)
protectedvirtual

Decodes the variable bindings from the specified buffer.

Reimplemented from DtRwPropertiesList.

virtual void DtRwPropertiesMap::getData ( const DtEnvironmentSP  ,
const DtEnvValueSP  ,
const DtReaderWriter::SearchPaths searchPaths,
const DtVariableBindingsList bindings 
)
protectedvirtual

Gets data from the environment value.

Reimplemented from DtRwPropertiesList.

virtual void DtRwPropertiesMap::putData ( DtEnvironmentSP  ,
DtEnvValueSP  value 
) const
protectedvirtual

Override to add attributes of actual data.

Reimplemented from DtRwPropertiesList.

virtual void DtRwPropertiesMap::postWriteItem ( std::string &  fp,
DtReaderWriter rw,
int  indentLevel 
)
protectedvirtual

Reimplemented from DtRwPropertiesList.

virtual void DtRwPropertiesMap::preWriteItem ( std::string &  fp,
DtReaderWriter rw,
int  indentLevel 
)
protectedvirtual

Reimplemented from DtRwPropertiesList.

virtual DtPropertyInterface* DtRwPropertiesMap::scratchItem ( ) const
protectedvirtual
virtual const DtPropertyInterface* DtRwPropertiesMap::findPropertyInterfaceByStringKey ( const DtString keyStr) const
protectedvirtual

Finds an item's property interface by its string key.

Differs from findPropertyInterface in that it allows a '.' in the string, which findPropertyInterface assumes to be a delimiter indicating the name of a new field within a property.

virtual DtPropertyInterface* DtRwPropertiesMap::findPropertyInterfaceByStringKey ( const DtString keyStr)
protectedvirtual

Member Data Documentation

DtPropertyInterface* DtRwPropertiesMap::myKeyType
mutableprotected
DtPropertyInterface* DtRwPropertiesMap::myScratchItem
mutableprotected

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

Document ID: Generated on Thu Aug 27 10:56:05 EDT 2020 from SVN revision 217100
Copyright © 2005-2020 MAK Technologies. All Rights Reserved (www.mak.com)