Method setPrefixedDataField

Engine/source/console/simObject.cpp:1165–1205

//-----------------------------------------------------------------------------

void SimObject::setPrefixedDataField(StringTableEntry fieldName, const char *_array, const char *value)
{
   // Sanity!
   AssertFatal(fieldName != NULL, "Cannot set object field value with NULL field name.");
   AssertFatal(value != NULL, "Field value cannot be NULL.");

   // Set value without prefix if there's no value.
   if (*value == 0)
   {
      setDataField(fieldName, _array, value);
      return;
   }

   // Fetch the field prefix.
   StringTableEntry fieldPrefix = getDataFieldPrefix(fieldName);

   // Sanity.
   AssertFatal(fieldPrefix != NULL, "Field prefix cannot be NULL.");

   // Do we have a field prefix?
   if (fieldPrefix == StringTable->EmptyString())
   {
      // No, so set the data field in the usual way.
      setDataField(fieldName, _array, value);
      return;
   }

   // Yes, so fetch the length of the field prefix.
   const U32 fieldPrefixLength = dStrlen(fieldPrefix);

   // Yes, so does it start with the object field prefix?
   if (dStrnicmp(value, fieldPrefix, fieldPrefixLength) != 0)
   {
      // No, so set the data field in the usual way.
      setDataField(fieldName, _array, value);
      return;
   }

   // Yes, so set the data excluding the prefix.
   setDataField(fieldName, _array, value + fieldPrefixLength);
}

//-----------------------------------------------------------------------------